[#BloombergLP-bdljsn-Tokenizer-setAllowUnescapedControlCharacters]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdljsn.adoc[bdljsn]::xref:BloombergLP/bdljsn/Tokenizer.adoc[Tokenizer]::setAllowUnescapedControlCharacters
:relfileprefix: ../../../
:mrdocs:

Set the `allowUnescapedControlCharacters` option to the specified `value`&period;

== Synopsis

Declared in `&lt;bdljsn&lowbar;tokenizer&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/bdljsn/Tokenizer.adoc[Tokenizer]&
setAllowUnescapedControlCharacters(bool value);
----

== Description

If `true`, characters in the range `&lsqb; 0x00 &period;&period; 0x1F &rsqb;` are allowed in JSON strings&period; If the option is `false`, these characters must be represented by their six byte escape sequences `&lsqb; u0000 &period;&period; u001F &rsqb;`&period; Several values in that range are also (conveniently) represented by two byte sequences&colon; &grave; &quot; quotation mark reverse solidus &sol; solidus *backspace* f form feed line feed r carriage return t tab &grave; The `DEL` control character (`0x7F`) is accepted even in strict mode&period;

The behavior is undefined unless `e&lowbar;RELAXED &equals;&equals; conformanceMode()`&period; Note that the representation of these byte sequences as C&sol;C&plus;&plus; string literals requires that the escape character itself must be escaped&colon; &grave; &quot;Hello,&bsol;tworld&bsol;n&quot;&semi; &sol;&sol; Can always initialize a JSON string with &sol;&sol; containing tab and a newline &sol;&sol; escape sequences &sol;&sol; whether the option is set or not&period;

&quot;Hello,tworldn&quot;&semi; &sol;&sol; When this option is &apos;true&apos;&period; &sol;&sol; can also initialize a JSON string &sol;&sol; with an actual and newline characters&period; &grave; Also note that the two resulting strings do _not_ compare equal&period;

== Return Value

a non&hyphen;`const` reference to this tokenizer

== Parameters

[cols="1,4"]
|===
| Name| Description
| *value*
| new value for `allowUnescapedControlCharacters`
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#
