Programmer Guide/Command Reference/TRANSLATE: Difference between revisions

From STX Wiki
Jump to navigationJump to search
m (1 revision: Initial import)
No edit summary
Line 1: Line 1:
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
==TRANSLATE==
<var>#str</var> := TRANSLATE <var>string</var> <var>sub<sub>1</sub></var> <var>trn<sub>1</sub></var> [ <var>sub<sub>X</sub></var> <var>trn<sub>X</sub></var> [ &hellip; ]]
<var>#str</var> := TRANSLATE <var>variable</var> <var>sub<sub>1</sub></var> <var>trn<sub>1</sub></var> [ <var>sub<sub>X</sub></var> <var>trn<sub>X</sub></var> [ &hellip; ]] /Variable
<var>#str</var> := TRANSLATE <var>tabke</var> <var>sub<sub>1</sub></var> <var>trn<sub>1</sub></var> [ <var>sub<sub>X</sub></var> <var>trn<sub>X</sub></var> [ &hellip; ]] /Table


<code>#str := TRANSLATE <var>string</var> <var>sub1</var> <var>trn1</var> [ <var>subX</var> <var>trnX</var> [ ... ]] [ /V|T ]</code>
The {{STx}} command <code>TRANSLATE</code> returns a modified copy of its <var>string</var> argument, the modification being that all occurrences of the string <var>sub<sub>N</sub></var> are replaced by the string <var>trn<sub>N</sub></var>.


Translate all occurrences of the string '<var>subX</var>' in '<var>string</var>' to '<var>trnX</var>'. The translated string is assigned to #str.
If the option <var>/Variable</var> is specified, <var>string</var> is treated as the name of a variable whose contents will be used as the string to <code>TRANSLATE</code>. If the option <code>/Table</code> is specified, <var>string</var> is treated as the name of a table item whose contents will be used as the string to <code>TRANSLATE</code>.
 
If the option /V is specified, string is treated as the name of a variable whose contents are searched. If the option /T is specified, string is treated as the name of a table item whose contents are searched.


<pre>
<pre>

Revision as of 16:03, 2 May 2014

#str := TRANSLATE string sub1 trn1 [ subX trnX [ … ]]
#str := TRANSLATE variable sub1 trn1 [ subX trnX [ … ]] /Variable
#str := TRANSLATE tabke sub1 trn1 [ subX trnX [ … ]] /Table

The STx command TRANSLATE returns a modified copy of its string argument, the modification being that all occurrences of the string subN are replaced by the string trnN.

If the option /Variable is specified, string is treated as the name of a variable whose contents will be used as the string to TRANSLATE. If the option /Table is specified, string is treated as the name of a table item whose contents will be used as the string to TRANSLATE.

#str := TRANSLATE 'I am getting tired of going to bed early' 'ing' 'ed'
um $#str

Navigation menu

Personal tools