Difference between revisions of "Chr"

Latest revision as of 22:22, 1 March 2017

Chr(n)

Returns the character as a text that corresponds to the numerical Unicode value «n» (a number between 0 and 1,114,111=0x10FFFF). Chr and Asc are inverses of each other, for example:

Chr(65) → ‘A’

Asc('A') → 65

Chr is useful for creating characters that cannot easily be typed, such as tab, which is Chr(9) and new line or carriage return (CR), which is Chr(13). For example, if you read in a text file, x, you can use SplitText(x, Chr(13)) to split the file up at each new line character into an array of lines.

Examples

Chr(65) → 'A'

JoinText(Chr(945..969)) → "αβγδεζηθικλμνξοπρςστυφχψω"

Chr(0x27000) → '𧀀'

History

Starting in Analytica 5.0, the accepted range is 0 to 0x10FFFF, which includes the unicode supplemental planes 0x10000 to 0x10FFFF.
In Analytica 4.5 and Analytica 4.6, «n» must be between 0 and 65535 = 0xFFFF.
Before Analytica 4.5, «n» was limited to 0-255.

@@ Line 1: / Line 1: @@
 [[category:Text Functions]]
-{{stub}}
+== Chr(n) ==
+Returns the character as a text that corresponds to the numerical Unicode value «n» (a number between 0 and 1,114,111=0x10FFFF). [[Chr]] and [[Asc]] are inverses of each other, for example:
+:<code>Chr(65) &rarr; ‘A’</code>
+:<code>Asc('A') &rarr; 65</code>
+[[Chr]] is useful for creating characters that cannot easily be typed, such as tab, which is [[Chr]](9) and new line or carriage return (CR), which is [[Chr]](13). For example, if you [[ReadTextFile|read in a text file]], <code>x</code>, you can use <code>SplitText(x, Chr(13))</code> to split the file up at each new line character into an array of lines.
+== Examples ==
+:<code>[[Chr]](65) &rarr; 'A'</code>
+:<code>[[JoinText]]([[Chr]](945..969)) &rarr; "αβγδεζηθικλμνξοπρςστυφχψω"</code>
+:<code>[[Chr]](0x27000)</code> &rarr; '𧀀'
+== History ==
+* Starting in [[Analytica 5.0]], the accepted range is 0 to 0x10FFFF, which includes the unicode supplemental planes 0x10000 to 0x10FFFF.
+* In [[Analytica 4.5]] and [[Analytica 4.6]], «n» must be between 0 and 65535 = 0xFFFF.
+* Before [[Analytica 4.5]], «n» was limited to 0-255.
+== See Also ==
+* [[Asc]]
+* [[SplitText]]
+* [[Text functions]]
+* [[Model File Character Encoding]]