UnicodeToUtf16 (Unicode function)

From m204wiki
Revision as of 15:49, 20 January 2011 by Wiccan (talk | contribs) (1 revision)
Jump to navigation Jump to search

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:
  • If its value is True, the "Byte Order Mark" (U+FEFF) is inserted at the start of the output stream.
  • If its value is False, the default, no Byte Order Mark is inserted.

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

Examples

The following fragment shows a successful call of UnicodeToUtf16. The U constant function and StringToHex function are used in the example.

    %u <var>Unicode</var> Initial('&#x31;':U)
    Print %u:<var>UnicodeToUtf16</var>:<var>String</var>ToHex
    Print %u:<var>UnicodeToUtf16</var>(InsertBOM=True):<var>String</var>ToHex

The result is:

    0031
    FEFF0031