UnicodeChar (Unicode function)

From m204wiki
Revision as of 20:28, 25 February 2011 by JAL (talk | contribs) (→‎Usage notes)
Jump to navigation Jump to search

The value at a specified position in the input string (Unicode class)


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

Syntax

%outUnicode = unicode:UnicodeChar( position)

Syntax terms

%outUnicode A Unicode variable to receive the result of the UnicodeChar method.
unicode A Unicode string.
position The position in the method object string, unicode, 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 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 with a length argument of 1.
  • The UnicodeChar method is analogous to the intrinsic String Char function.
  • UnicodeChar is available as of Sirius Mods Version 7.5.

Example

  1. 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.

See also

  • the instrinsic String U function