Utf8ToUnicode (String function)

Convert a UTF-8 Longstring bytestream to Unicode (String class)

The Utf8ToUnicode intrinsic function converts a UTF-8 string to Unicode.

Syntax

%unicode = string:Utf8ToUnicode[( [AllowUntranslatable= boolean])] Throws CharacterTranslationException

Syntax terms

%unicode	A Unicode string variable to receive the method object string translated to Unicode.
string	The method object string that is presumed to contain a UTF-8 byte stream.
AllowUntranslatable	This argument is usable only by Sirius Software.

Exceptions

Utf8ToUnicode 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

• Utf8ToUnicode is available as of Sirius Mods Version 7.3.

Examples

1. In the following fragment, Utf8ToUnicode converts a hexadecimal input to a single Unicode character. In case the Unicode character translates to an EBCDIC character that cannot be displayed, the CharacterEncode option of UnicodeToEbcdic causes the output of a hexadecimal character reference.

   %u unicode %u = 'E284A2':X:Utf8ToUnicode print %u:unicodeToEbcdic(CharacterEncode=true)

   The result of the above fragment is the character reference for the trademark character:

   ™

See also

• Utf8 and Utf16 has more information about UTF-8 conversions.
• UnicodeToUtf8 converts a Unicode string to a UTF-8 Longstring byte stream.
• Utf16ToUnicode converts a UTF-16 byte stream to Unicode.

Float class String class Unicode class	List of Float methods List of String methods List of Unicode methods List of Intrinsic methods	Float methods syntax String methods syntax Unicode methods syntax
Notation conventions for methods