<doc>
	<legacy_id>1150</legacy_id>
	<name>useUnicode</name>
	<type>property</type>

	<syntax>
		<example>set the useUnicode to {true | false}</example>
		<example></example>
		<example></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies whether the charToNum and numToChar functions assume a character is double-byte.</summary>

	<examples>
<example><p>set the useUnicode to true</p></example>
<example><p>set the useUnicode to (the number of items of myFont is 2)</p></example>
<example><p></p></example>
<example><p></p></example>
<example><p></p></example>
	</examples>

	<history>
		<introduced version="2.0">Added.</introduced>
		<deprecated version="7.0">7.0</deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
		<local/>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>Text and Data Processing</category>
		<category></category>
		<category></category>
	</classification>

	<references>
		<function tag="numToChar">numToChar function</function>
		<property tag="allowInlineInput">allowInlineInput property</property>
	</references>

	<description>
	<overview>Use the <b>useUnicode</b> property to prepare to convert between Unicode characters and their numeric values.</overview>

		<parameters>
		</parameters>

	<value>By default, the <b>useUnicode</b> property is false.</value>
	<comments><p>If the useUnicode property is set to true, the numToChar and charToNum functions use double-byte characters. You can pass a number greater than 255 to the numToChar function in order to generate a double-byte character, and you can pass a double-byte character to the charToNum function.</p><p></p><p>If the useUnicode is false, the numToChar and charToNum functions use single-byte characters. Passing a double-byte character to charToNum or a number larger than 255 to numToChar will produce incorrect results if the useUnicode is false.</p><p></p><p>Since the useUnicode is a local property, its value is reset to false when the current handler finishes executing. It retains its value only for the current handler, and setting it in one handler does not affect its value in other handlers it calls.</p><p></p><p>Deprecated: In LiveCode 7.0 the language was changed to handle unicode transparently. This means that language functionality which previously aided unicode text manipulation is no longer required. This property should not be used in new code, as it only affects the behaviour of numToChar and charToNum, which are themselves deprecated.</p></comments>
	</description>
</doc>