Translate (String function)

Apply a Character Map to the method object string (String class)

The Translate method takes a string or longstring input and outputs a copy of it in which any of the input characters that are specified in a character mapping object are replaced with the characters to which they are mapped by the object.

Translate has many similarities to the Sirius function $LSTR_TRANSLATE, which is described in the Sirius Functions Reference Manual.

The Translate method takes a CharacterMap object as input. A CharacterMap object maps In ("input table") characters to Out ("output table") characters.

Syntax

%outString = string:Translate( characterMap)

Syntax terms

%outStr	A string or Longstring to receive the translated input string.
string	The input string or Longstring.
charMap	A CharacterMap object variable which indicates the output characters to which specified input characters are to be mapped.

Usage notes

• For information about constructing a CharacterMap object, see CharacterMap New constructor.

Examples

In the following request, a's are translated to B's, and c's are translated to d's, as dictated by the character mapping in %map:

   Begin                                                                                         
   %map is object characterMap 
   %ls is longstring                                               
                                                                   
   %map = new(in='ac',out='Bd')                                    
   %ls = 'aaaccc'                                                  
   printText {~} = '{%ls:translate(%map)}' 
   End                                                             
                                                                   

The result is:

   %ls:translate(%tr) = 'BBBddd'

See also

List of intrinsic String methods