UnicodeChar (Unicode function)

Single character at specified position of string

This function returns the string value of the single character at a specified position in the method object Unicode string.

The UnicodeChar function is available as of version 7.5 of the Sirius Mods.

Syntax

  %outUni = unicode:UnicodeChar(position)

Syntax Terms

%outUni

A Unicode variable to receive the result of the UnicodeChar method.

unicode

A Unicode string.

position

The position in the method object string of the character you want to identify. A value of 1 finds the first character in the string.

Usage Notes

• The position value must be a non-negative, non-zero number; a zero or negative number results in request cancellation. A length value greater than the declared length of the output string results in request cancellation.
• For a given position, the UnicodeChar function returns the same value as the UnicodeSubstring function (described ??UnicodeSubstring) with a length argument of 1.
• The UnicodeChar method is analogous to the String intrinsic Char method (??Char).

Example

The following request calls UnicodeChar two times:

    Begin
      printText {'inaugural':unicodeChar(5)}
      %u is unicode initial('xyz¡':U)
      printText {%u:unicodeChar(4)}
    End

The result is:

    g
    ?

The question mark in the result represents an EBCDIC character that is not displayable. The U constant function used in the example is described ??U. For information about the PrintText statement, see the list item ?? refid=intprnt..