Programmer Guide/Command Reference/TRANSLATE: Difference between revisions
From STX Wiki
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:{{SUBPAGENAME}}}} | {{DISPLAYTITLE:{{SUBPAGENAME}}}} | ||
<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> … ] | <var>#str</var> := TRANSLATE [[Programmer_Guide/Command_Reference_Options/-|/-]] <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> … ] | ||
<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> … ] | <var>#str</var> := TRANSLATE /Variable [[Programmer_Guide/Command_Reference_Options/-|/-]] <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> … ] | ||
<var>#str</var> := TRANSLATE <var>table</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> … ] | <var>#str</var> := TRANSLATE /Table [[Programmer_Guide/Command_Reference_Options/-|/-]] <var>table</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> … ] | ||
The {{STx}} command <code>TRANSLATE</code> returns a modified copy of its 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>. | The {{STx}} command <code>TRANSLATE</code> returns a modified copy of its 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>. | ||
Revision as of 15:11, 2 May 2014
#str := TRANSLATE /- string sub1 trn1 [ subX trnX … ] #str := TRANSLATE /Variable /- variable sub1 trn1 [ subX trnX … ] #str := TRANSLATE /Table /- table sub1 trn1 [ subX trnX … ]
The STx command TRANSLATE returns a modified copy of its argument, the modification being that all occurrences of the string subN are replaced by the string trnN.
In its first form, the argument string is taken as a string literal. With option /Variable, the command will be return the modified content of the STx variable variable, while with option /Table, TRANSLATE will return the modified contents of an STx table denoted by the table argument. In either case the content of the respective variable or table will be left untouched.
#str := TRANSLATE 'I am getting tired of going to bed early' 'ing' 'ed' um $#str
