Programmer Guide/Command Reference/TRANSLATE: Difference between revisions
From STX Wiki
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| Line 4: | Line 4: | ||
<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> … ] /Table | <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> … ] /Table | ||
The {{STx}} command <code>TRANSLATE</code> returns a modified copy of its | 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>. | ||
In its first form, the argument <var>string</var> is taken as a string literal. With option <code>/Variable</code>, the command will be return the modified ''content'' of the {{Stx}} variable <var>variable</var>, while with option <code>/Table</code>, <code>TRANSLATE</code> will return the modified contents of an {{STX}} table denoted by the <var>table</var> 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' | |||
#str := TRANSLATE 'I am getting tired of going to bed early' 'ing' 'ed' | um $#str | ||
um $#str | |||
Revision as of 16:07, 2 May 2014
#str := TRANSLATE string sub1 trn1 [ subX trnX … ] #str := TRANSLATE variable sub1 trn1 [ subX trnX … ] /Variable #str := TRANSLATE table sub1 trn1 [ subX trnX … ] /Table
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
