<doc>
	<legacy_id></legacy_id>
	<name>numToCodepoint</name>
	<type>function</type>

	<syntax>
		<example>numToCodepoint(<i>number</i>)</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Converts an integer to a Unicode codepoint.</summary>

	<examples>
<example>numToCodepoint(0x41) -- returns "A"</example>
<example>put numToCodepoint(0x20) is space -- returns true</example>
	</examples>

	<history>
		<introduced version="7.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<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>
	</classification>

	<references>
		<function tag="codepointToNum">codepointToNum function</function>
		<function tag="numToNativeChar">numToNativeChar function</function>
		<function tag="nativeCharToNum">nativeCharToNum function</function>
		<function tag="normalizeText">normalizeText function</function>
		<function tag="codepointProperty">codepointProperty function</function>
	</references>

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

		<parameters>
  <parameter>
    <name>number</name>
    <description>An integer in the range 0x000000 to 0x10FFFF. The number can be given in hex or decimal form.</description>
  </parameter>		</parameters>

	<value>The <b>numToCodepoint</b> function returns a single Unicode codepoint.</value>
	<comments>The <b>numToCodepoint</b> function takes the numerical identifier of a Unicode character and returns its textual form. <p></p><p>Integers in the range 0x000000 to 0x10FFFF can be used to  identify Unicode characters. For example, the space character is 0x20 and A is 0x41.</p><p></p><p>The <b>numToCodepoint</b> function raises an exception if the given integer is out of range for Unicode codepoints (i.e if it is negative or if it is greater than 0x10FFFF). Codepoints that are not currently assigned to characters by the latest Unicode standard are not considered to be invalid in order to ensure compatibility with future standards.</p></comments>
	</description>
</doc>