Translate   built-in function

The Translate function returns a translation of the characters in an original string.

result = Translate( string [, [after] [, [before] [, pad ] ] ] )

string

the original string containing characters to translate

after

an optional string of replacement characters

before

an optional string of original characters. When this argument is specified the original string is scanned for the characters in the before string, and replaces characters which match with the corresponding character in the after string. This can be understood better by studying the examples below.

pad

an optional padding character. The after argument is padded on the right with this character, until it has the same length as the before argument. The default padding character is a space.

When both before and after arguments are absent, the function converts the original string to upper case.

Examples: say Translate( 'abracadabra' ) -- shows: ABRACADABRA say Translate( '01101', '01', '10' ) -- shows: 10010, same as BitXor( '01101' ) say Translate( 'abracadabra', 'ba', 'ab' ) -- shows: barbcbdbarb say Translate( 'abracadabra', , 'ab' ) -- shows: ' r c d r ', (notice the absence of the before argument!) say Translate( 'abracadabra', , 'a', '+' ) -- shows: +br+c+d+br+, (notice the absence of the before argument!) say Translate( 'AbraCaDabra', xrange( 'a', 'z' ), xrange( 'A', 'Z' ) ) -- shows: abracadabra ( !!! in Ascii environments -- EBCDIC environments need multiple xrange's -- as follows) LowerEbcdic : procedure return translate( , , xrange( 'a', 'i' )xrange( 'j', 'r' )xrange( 's', 'z' ), , xrange( 'A', 'I' )xrange( 'J', 'R' )xrange( 'S', 'Z' ) )