UnicodeReplace (Unicode function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
m (tags and edits)
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.
<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.
<p>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"]].</p>  
   
   
==Syntax==
==Syntax==
Line 15: Line 15:
==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]]</var> Version 7.3.
<li><var>UnicodeReplace</var> is available as of <var class="product">[[Sirius Mods|"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.
<ol><li>In actual usage, updating UNICODE commands should only be issued from your <var class="product">Model 204</var> initialization stream. For the sake of this example, assume that the following had been included:
<p class="code">UNICODE Table Standard Rep U=2122 '(TM)'</p>
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.
accordingly, a subsequent <var>UnicodeReplace</var> example:
<p class="code">UNICODE Table Standard Rep U=2122 '(TM)'
<p class="code">begin
begin
   %u Unicode Initial('Cool&amp;#x2122;':[[U (String function)|U]])
   %u Unicode Initial('Cool&amp;#x2122;':U)
   print %u:UnicodeReplace
   print %u:UnicodeReplace
end
end
</p>
</p>
The result is:
would result is:
<p class="output">Cool(TM)
<p class="output">Cool(TM)
</p>
</p></ol>
   
   
==See also==
==See also==
{{Template:Unicode:UnicodeReplace footer}}
{{Template:Unicode:UnicodeReplace footer}}

Revision as of 00:31, 14 March 2011

Apply the replacement table to this string (Unicode class)

UnicodeReplace lets you examine a given Unicode string for any replacement characters that may be in effect at your site.

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

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

  1. In actual usage, updating UNICODE commands should only be issued from your Model 204 initialization stream. For the sake of this example, assume that the following had been included:

    UNICODE Table Standard Rep U=2122 '(TM)'

    accordingly, a subsequent UnicodeReplace example:

    begin %u Unicode Initial('Cool&#x2122;':U) print %u:UnicodeReplace end

    would result is:

    Cool(TM)

See also