U (String function)

Convert EBCDIC string to Unicode constant, including character encoding (String class)

The U intrinsic method converts an EBCDIC string, which may include XML character and entity references, to a Unicode string. The function also converts XML style hexadecimal character references and XHTML entity references to the represented Unicode character. Since in use the method acts like a Unicode constant, it is also included in the list of Constant methods.

Syntax

%unicode = string:U

Syntax terms

%unicode

A Unicode variable to receive the Unicode string represented by the method object string.

string

A constant character string value, which may include an XML-style hexadecimal character reference or an XHTML entity reference. That is, string may contain an ampersand (&) in the following cases: At the start of the substring &. This substring is converted to a single ampersand (&) character. At the start of a hexadecimal character reference: for example, the eight characters “ for the Unicode "Left double quotation mark" (“). The character reference is converted to the referenced character. As of Sirius Mods Version 7.6, an XHTML entity reference (for example, the six characters   for the "non-breaking-space" character). The entity reference is converted to the referenced character. A decimal character reference (for example, ¬) is not allowed.

Usage notes

• U is a compile-time-only equivalent of the EbcdicToUnicode method of the intrinsic string class (with its CharacterDecode argument implicitly set to True).
• Using the U method (or EbcdicToUnicode) is necessary for converting to type Unicode if the string you want to convert may contain a hexadecimal character reference. Such a reference cannot be meaningfully assigned to a Unicode variable otherwise, whereas keyboard-available characters can simply be assigned directly to a Unicode variable without character reference and without conversion by U.
• The U method is available as of Sirius Mods Version 7.3.

Examples

1. The following Print statement displays a plus sign (+):

   %p Unicode Initial('+') print %p

2. The following Print statement displays a copyright sign (©):

   %copy Unicode Initial('©':U) print %copy

3. The following Print statement displays 2122:

   %tm Unicode Initial('™':U) print %tm:UnicodeToUtf16:StringToHex

   Simply specifying print %tm in the previous example above would attempt to convert to EBCDIC, but since the Unicode trademark character does not translate to a valid EBCDIC character, the Print output will use a character reference: ™.

See also

• You can find the list of XHTML entities on the Internet at the following URL:

  http://www.w3.org/TR/xhtml1/dtds.html#h-A2

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