Utf16ToUnicode (String function): Difference between revisions
Jump to navigation
Jump to search
m (→Syntax terms) |
m (→Examples) |
||
Line 26: | Line 26: | ||
==Examples== | ==Examples== | ||
In the following fragment, <var>Utf16ToUnicode</var> converts a hexadecimal input to a single <var>Unicode</var> character. | |||
<p class="code">%u unicode | <p class="code">%u unicode | ||
%u = '0032':[[X (String function)|X]]:Utf16ToUnicode | %u = '0032':[[X (String function)|X]]:Utf16ToUnicode | ||
Line 33: | Line 33: | ||
The result is: | The result is: | ||
<p class="output">2 | <p class="output">2 | ||
</p | </p> | ||
==See also== | ==See also== |
Revision as of 20:08, 23 May 2011
Convert a UTF-16 Longstring bytestream to Unicode (String class)
The Utf16ToUnicode intrinsic function converts a UTF-16 Longstring byte stream to Unicode.
Syntax
%unicode = string:Utf16ToUnicode[( [AllowUntranslatable= boolean], - [Bom= utf16BOM])] Throws CharacterTranslationException
Syntax terms
%unicode | A string variable to receive the method object string translated to Unicode. |
---|---|
string | A string that is presumed to contain a UTF-16 byte stream. |
AllowUntranslatable | AllowUntranslatable is an optional, but name required, parameter that is a "Boolean Enumeration" value that specifies .... ?? must fix this |
Exceptions
Utf16ToUnicode can throw the following exception:
- CharacterTranslationException
- If the method encounters a translation problem, properties of the exception object may indicate the location and type of problem.
Usage notes
- The input UTF-16 stream may contain a Byte Order Mark (U+FEFF).
- If one is present, that controls the conversion from UTF-16 to Unicode.
- If a Byte Order Mark is not present, the input stream is considered to be a Big Endian stream, that is, it is the same as if the stream were preceded by the two bytes X'FE' and X'FF', in that order.
- The Utf16ToUnicode function is available as of Sirius Mods Version 7.3.
Examples
In the following fragment, Utf16ToUnicode converts a hexadecimal input to a single Unicode character.
%u unicode %u = '0032':X:Utf16ToUnicode print %u
The result is:
2
See also
- UTF-8 and UTF-16 has more information about UTF-16 conversions.
- The Utf8ToUnicode method converts a UTF-8 byte stream to Unicode.