UnicodeChar (Unicode function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
 
(27 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Template:Unicode:UnicodeChar subtitle}}
{{Template:Unicode:UnicodeChar subtitle}}
[[Category:Unicode methods|UnicodeChar function]]
[[Category:Intrinsic methods]]
<!--DPL?? Category:Unicode methods|<var>UnicodeChar</var> function: Single character at specified position of string-->
<!--DPL?? Category:Intrinsic methods|<var>UnicodeChar</var> (Unicode function): Single character at specified position of string-->
<!--DPL?? Category:System methods|<var>UnicodeChar</var> (Unicode function): Single character at specified position of string-->


This function returns the string value of the single character at a specified
<var>UnicodeChar</var> returns the string value of the single character at a specified position in the method object <var>Unicode</var> string.
position in the method object Unicode string.


The <var>UnicodeChar</var> function is available as of version 7.5  of the <var class=product>Sirius Mods</var>.
==Syntax==
==Syntax==
{{Template:Unicode:UnicodeChar syntax}}
{{Template:Unicode:UnicodeChar syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th><i>%outUni</i> </th>
<tr><th>%outUnicode</th>
<td>A Unicode variable to receive the result of the <var>UnicodeChar</var> method. </td></tr>
<td>A <var>Unicode</var> variable to receive the result of the <var>UnicodeChar</var> method.</td></tr>
<tr><th><i>unicode</i> </th>
<tr><th>unicode</th>
<td>A Unicode string. </td></tr>
<td>A <var>Unicode</var> string.</td></tr>
<tr><th><i>position</i> </th>
<tr><th>position</th>
<td>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.</td></tr>
<td>The position in the method object string, <var class="term">unicode</var>, of the character you want to identify. A value of 1 finds the first character in the string.</td></tr>
</table>
</table>
==Usage notes==
==Usage notes==
<ul>
<ul>
<li>The ''position'' value must be a non-negative, non-zero number;
<li>The <var class="term">position</var> 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.
a zero or negative number results in request cancellation.
<li>For a given <var class="term">position</var>, the <var>UnicodeChar</var> function returns the same value as <var>[[UnicodeSubstring (Unicode function)|UnicodeSubstring]]</var> with a length argument of <code>1</code>.
A ''length'' value greater than the declared length
<li>The <var>UnicodeChar</var> method is analogous to the intrinsic <var>String</var> <var>[[Char (String function)|Char]]</var> function.
of the output string results in request cancellation.
<li><var>UnicodeChar</var> is available as of <var class="product">Sirius Mods</var> Version 7.5.
<li>For a given position, the <var>UnicodeChar</var> function returns the same value as
the [[UnicodeSubstring (Unicode function)|UnicodeSubstring]] function with a length argument of <tt>1</tt>.
<li>The <var>UnicodeChar</var> method is analogous to
the intrinsic String [[Char (String function)|Char]] function.
</ul>
</ul>
===Example===


==Example==
The following request calls <var>UnicodeChar</var> two times:
The following request calls <var>UnicodeChar</var> two times:
<pre>
<p class="code">begin
    Begin
  [[PrintText statement|printText]] {'inaugural':unicodeChar(5)}
      printText {'inaugural':unicodeChar(5)}
  %u is unicode initial('xyz&amp;#xA1;':[[U (String function)|U]])
      %u is unicode initial('xyz&amp;#xA1;':U
  printText {%u:unicodeChar(4)}
      printText {%u:unicodeChar(4)}
end
    End
</p>
</pre>


The result is:
The result is:
<pre>
<p class="output">g
    g
?
    ?
</p>
</pre>


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


For further information about the above request, see descriptions of:
==See also==
<ul>
<ul>
<li>the [[Intrinsic classes#printtext|PrintText]] statement
<li><var>[[U (String function)]]</var>
<li>the instrinsic String [[U (String function)|U]] function
</ul>
</ul>
{{Template:Unicode:UnicodeChar footer}}

Latest revision as of 17:04, 6 November 2012

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


UnicodeChar 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 UnicodeSubstring 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

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.

See also