UnicodeToUtf16 (Unicode function): Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
m (1 revision) |
||
| Line 13: | Line 13: | ||
{{Template:Unicode:UnicodeToUtf16 syntax}} | {{Template:Unicode:UnicodeToUtf16 syntax}} | ||
===Syntax terms=== | ===Syntax terms=== | ||
< | <table class="syntaxTable"> | ||
< | <tr><th><i>%utf16Stream</i> </th> | ||
< | <td>A String or Longstring variable to receive the method object string translated to a UTF-16 Big-Endian byte stream (that is, any Unicode point U+wxyz results in the pair of bytes X'wx' and X'yz', in that order). </td></tr> | ||
translated to a UTF-16 Big-Endian byte stream | <tr><th><i>unicode</i> </th> | ||
(that is, any Unicode point U+wxyz results in the pair of bytes | <td>A Unicode string. </td></tr> | ||
X'wx' and X'yz', in that order). | <tr><th><b>InsertBOM=</b><i>bool</i> </th> | ||
< | <td>The optional (name required) InsertBOM argument is a Boolean: <ul> <li>If its value is <tt>True</tt>, the "Byte Order Mark" (U+FEFF) is inserted at the start of the output stream. <li>If its value is <tt>False</tt>, the default, no Byte Order Mark is inserted. </ul></td></tr> | ||
< | </table> | ||
< | |||
< | |||
<ul> | |||
<li>If its value is <tt>True</tt>, the "Byte Order | |||
Mark" (U+FEFF) is inserted at the start of the output | |||
stream. | |||
<li>If its value is <tt>False</tt>, the default, | |||
no Byte Order Mark is inserted. | |||
</ul> | |||
</ | |||
===Exceptions=== | ===Exceptions=== | ||
Revision as of 04:34, 19 January 2011
Translate to UTF-16 (Unicode class)
This function converts a Unicode string to a UTF-16 Longstring byte stream.
The UnicodeToUtf16 function is available as of version 7.3 of the Sirius Mods.
Syntax
%string = unicode:UnicodeToUtf16[( [InsertBOM= boolean])]
Syntax terms
| %utf16Stream | A String or Longstring variable to receive the method object string translated to a UTF-16 Big-Endian byte stream (that is, any Unicode point U+wxyz results in the pair of bytes X'wx' and X'yz', in that order). |
|---|---|
| unicode | A Unicode string. |
| InsertBOM=bool | The optional (name required) InsertBOM argument is a Boolean:
|
Exceptions
This function 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. See CharacterTranslationException exception class.
Usage notes
- For more information about UTF-16 conversions, see Unicode#UTF-8 and UTF-16.
- The UnicodeToUtf8 method converts a Unicode string to UTF-8.
- The Utf16ToUnicode method converts a UTF-16 Longstring byte stream to Unicode.
Examples
The following fragment shows a successful call of UnicodeToUtf16. The U constant function and StringToHex function are used in the example.
%u Unicode Initial('1':U)
Print %u:UnicodeToUtf16:StringToHex
Print %u:UnicodeToUtf16(InsertBOM=True):StringToHex
The result is:
0031
FEFF0031