<doc>
	<legacy_id>1137</legacy_id>
	<name>numToChar</name>
	<type>function</type>

	<syntax>
		<example>the numToChar of <i>ASCIIValue</i></example>
		<example>numToChar(<i>ASCIIValue</i>)</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary><glossary tag="return">Returns</glossary> the <keyword tag="character">character</keyword> corresponding to an <glossary tag="ASCII">ASCII value</glossary>.</summary>

	<examples>
<example>numToChar(65) </example>
<example>numToChar(0) </example>
	</examples>

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

	<objects>
	</objects>

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

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

	<security>
	</security>


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

	<references>
		<function tag="binaryDecode">binaryDecode Function</function>
		<function tag="binaryEncode">binaryEncode Function</function>
		<function tag="charToNum">charToNum Function</function>
		<function tag="ISOToMac">ISOToMac Function</function>
		<function tag="macToISO">macToISO Function</function>
		<function tag="toLower">toLower Function</function>
		<function tag="toUpper">toUpper Function</function>
		<function tag="uniEncode">uniEncode Function</function>
		<function tag="base64Encode">base64Encode Function</function>
		<property tag="charSet">charSet Property</property>
		<property tag="useUnicode">useUnicode Property</property>
		<property tag="HTMLText">HTMLText Property</property>
		<property tag="extendKey">extendKey Property</property>
	</references>

	<description>
	<overview>Use the <b>numToChar</b> function to translate numbers into their <keyword tag="character">character</keyword> equivalents, or to interpret a <keyword tag="character">character</keyword> (such as a control character) that can't be displayed.</overview>

		<parameters>
  <parameter>
    <name>ASCIIValue</name>
    <description>an integer between zero and 255, or an expression that evaluates to such an integer. If the useUnicode property is set to true, the ASCIIValue is an integer between zero and 65535.</description>
  </parameter>		</parameters>

	<value>The <b>numToChar</b> function <glossary tag="return">returns</glossary> a single <keyword tag="character">character</keyword>.</value>
	<comments><important><p>As of version 7.0 the numToChar and charToNum functions have been deprecated. They will continue to work as in previous versions but should not be used with Unicode text as unexpected results may occur. If working with Unicode text use the <function tag="numToCodepoint">numToCodepoint</function> and <function tag="codepointToNum">codepointToNum</function> functions, for native text use <function tag="numToNativeChar">numToNativeChar</function> and <function tag="nativeCharToNum">nativeCharToNum</function> functions. If working with binary data use the <function tag="numToByte">numToByte</function> and <function tag="byteToNum">byteToNum</function> functions.</important><p></p><p>The <b>numToChar</b> function is the <keyword tag="inverse">inverse</keyword> of the <function tag="charToNum">charToNum</function> <control_st tag="function">function</control_st>.</p><p></p><p>If the <i>ASCIIValue</i> is between 127 and 255, the <keyword tag="character">character</keyword> <glossary tag="return">returned</glossary> by the <b>numToChar</b> <control_st tag="function">function</control_st> depends on the <glossary tag="character set">character set</glossary> currently in use. On <glossary tag="Mac OS">Mac OS systems</glossary> this is usually the <glossary tag="Mac OS">Macintosh</glossary> <glossary tag="character set">character set</glossary>; on <glossary tag="Unix">Unix</glossary> systems, this is usually <glossary tag="ISO 8859">ISO 8859</glossary>; on <glossary tag="Windows">Windows systems</glossary>, this is usually Code Page 1252, a variant of <glossary tag="ISO 8859">ISO 8859</glossary>.</p><p></p><p>If the <b>useUnicode</b> <glossary tag="property">property</glossary> is set to true, the <b>numToChar</b> <control_st tag="function">function</control_st> <glossary tag="return">returns</glossary> a double-byte <i>character</i>. If the <property tag="useUnicode">useUnicode</property> is false and you specify an <i>ASCIIValue</i> greater than 255, the <b>numToChar</b> <control_st tag="function">function</control_st> <glossary tag="return">returns</glossary> the <keyword tag="character">character</keyword> corresponding to the <i>ASCIIValue</i> <operator tag="mod">mod</operator> 256.</p><p></p><p></p><p></p><change><p>The ability to handle Unicode characters was introduced in version 2.0. In previous versions, it was not possible for the <b>numToChar</b> function to return a <glossary tag="Unicode">Unicode</glossary> <keyword tag="character">character</keyword>.</change></comments>
	</description>
</doc>