UnicodeReplace (Unicode function): Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{Template:Unicode:UnicodeReplace subtitle}} | {{Template:Unicode:UnicodeReplace subtitle}} | ||
The <var class=product">Sirius Mods</var> Unicode tables specify translations between EBCDIC and Unicode/ASCII. | The <var class=product">Sirius Mods</var> Unicode tables specify translations between EBCDIC and Unicode/ASCII. | ||
The [[Unicode#UNICODE command|UNICODE command]] lets your site create customizations (one or many replacements) of those translations, as described in [[Unicode#Update forms of UNICODE|"Update forms of UNICODE"]]. <var>UnicodeReplace</var> lets you examine a given Unicode string for any replacement characters that may be in effect at your site. | The [[Unicode#UNICODE command|UNICODE command]] lets your site create customizations (one or many replacements) of those translations, as described in [[Unicode#Update forms of UNICODE|"Update forms of UNICODE"]]. <var>UnicodeReplace</var> lets you examine a given Unicode string for any replacement characters that may be in effect at your site. | ||
==Syntax== | ==Syntax== | ||
{{Template:Unicode:UnicodeReplace syntax}} | {{Template:Unicode:UnicodeReplace syntax}} | ||
| Line 12: | Line 12: | ||
<td>A <var>Unicode</var> string.</td></tr> | <td>A <var>Unicode</var> string.</td></tr> | ||
</table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
<ul><li>The method output is the input <var>Unicode</var> string, with those characters specified in the Unicode replacement table replaced by their corresponding <var>Unicode</var> strings. If no Unicode replacement table is in effect, the method merely copies its input. | <ul><li>The method output is the input <var>Unicode</var> string, with those characters specified in the Unicode replacement table replaced by their corresponding <var>Unicode</var> strings. If no Unicode replacement table is in effect, the method merely copies its input. | ||
<li><var>UnicodeReplace</var> is available as of <var class="product">[[Sirius Mods | <li><var>UnicodeReplace</var> is available as of <var class="product">[[Sirius Mods]]</var> Version 7.3. | ||
</ul> | </ul> | ||
==Examples== | ==Examples== | ||
The following example shows a successful call of <var>UnicodeReplace</var>. The [[U (String function)|U constant function]] is used in the example. | The following example shows a successful call of <var>UnicodeReplace</var>. The [[U (String function)|U constant function]] is used in the example. | ||
An updating UNICODE command is used "in-line" with the User Language request to make the example concrete. In actual usage, updating UNICODE commands should only be issued from your <var class="product">Model 204</var> initialization stream. | An updating UNICODE command is used "in-line" with the <var class="product">User Language</var> request to make the example concrete. In actual usage, updating UNICODE commands should only be issued from your <var class="product">Model 204</var> initialization stream. | ||
<p class="code">UNICODE Table Standard Rep U=2122 '(TM)' | <p class="code">UNICODE Table Standard Rep U=2122 '(TM)' | ||
begin | begin | ||
| Line 31: | Line 31: | ||
<p class="output">Cool(TM) | <p class="output">Cool(TM) | ||
</p> | </p> | ||
==See also== | ==See also== | ||
{{Template:Unicode:UnicodeReplace footer}} | {{Template:Unicode:UnicodeReplace footer}} | ||
Revision as of 22:51, 28 February 2011
Apply the replacement table to this string (Unicode class)
The Sirius Mods Unicode tables specify translations between EBCDIC and Unicode/ASCII. The UNICODE command lets your site create customizations (one or many replacements) of those translations, as described in "Update forms of UNICODE". UnicodeReplace lets you examine a given Unicode string for any replacement characters that may be in effect at your site.
Syntax
%outUnicode = unicode:UnicodeReplace
Syntax terms
| %outUnicode | A Unicode variable to receive the method object string altered by any replacement characters. |
|---|---|
| unicode | A Unicode string. |
Usage notes
- The method output is the input Unicode string, with those characters specified in the Unicode replacement table replaced by their corresponding Unicode strings. If no Unicode replacement table is in effect, the method merely copies its input.
- UnicodeReplace is available as of Sirius Mods Version 7.3.
Examples
The following example shows a successful call of UnicodeReplace. The U constant function is used in the example.
An updating UNICODE command is used "in-line" with the User Language request to make the example concrete. In actual usage, updating UNICODE commands should only be issued from your Model 204 initialization stream.
UNICODE Table Standard Rep U=2122 '(TM)' begin %u Unicode Initial('Cool™':U) print %u:UnicodeReplace end
The result is:
Cool(TM)