UnicodeChar (Unicode function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (Undo revision 21010 by Wiccan (talk))
m (Undo revision 21010 by Wiccan (talk))
Line 31: Line 31:
The following request calls <var>UnicodeChar</var> two times:
The following request calls <var>UnicodeChar</var> two times:
<p class="code">Begin
<p class="code">Begin
<p class="code">printText {'inaugural':unicodeChar(5)}
printText {'inaugural':unicodeChar(5)}
%u is unicode initial('xyz&amp;#xA1;':U
%u is unicode initial('xyz&amp;#xA1;':U
printText {%u:unicodeChar(4)}
printText {%u:unicodeChar(4)}
</p>
End
End
</p>
</p>

Revision as of 02:47, 7 February 2011

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


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

%outUnicode = 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 with a length argument of 1.
  • The UnicodeChar method is analogous to the intrinsic String Char function.

Example

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.

For further information about the above request, see descriptions of:

  • the PrintText statement
  • the instrinsic String U function

See also