UnicodeChar (Unicode function): Difference between revisions

Revision as of 23:20, 20 October 2010

This intrinsic 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.

  %outUni = unicode:UnicodeChar(position)

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

The position value must be a non-negative, non-zero number; a zero or negative number results in request cancellation.
For a given position, the UnicodeChar function returns the same value as UnicodeSubstring with a length argument of '1'.
The UnicodeChar method is analogous to the Char function

The following request calls UnicodeChar two times:

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

The result is:

   g
   ?

The question mark in the result represents an EBCDIC character that is not displayable.

@@ Line 21: / Line 21: @@
 *The ''position'' value must be a non-negative, non-zero number; a zero or negative number results in request cancellation.
 *For a given position, the UnicodeChar function returns the same value as [[Intrinsic UnicodeSubstring Function|UnicodeSubstring]] with a length argument of ''''1''''.
-*The UnicodeChar method is analogous to the [[Intrinsic Char Function|Char function]]
+*The UnicodeChar method is analogous to the [[Char (String function)|Char function]]
 ===Examples===