TRANSLATE

TRANSLATE changes text based on provided translation tables. Text to be changed is passed as the first parameter. Replacements are placed in the second parameter, and specific characters to be replaced are passed in the third parameter. If a character is found in the first parameter that matches a character in the third parameter, the corresponding character in the second parameter replaces the first parameter character. This needs an example. If there is no substitution character in the second parameter, a space is inserted in the original text (first parameter).

The fourth parameter, IN_PLACE|NOT_IN_PLACE, has no effect in nu/TPU and is provided only for VAX TPU source code compatibility.

Syntax:

text := TRANSLATE ( text, string, string )

text := TRANSLATE ( text, string, string, { IN_PLACE | NOT_INPLACE } )

Valid text types are: Buffer, Range, or String.

Example:

The following example changes the entire current buffer to uppercase.

TRANSLATE (CURRENT_BUFFER, "ABCDEFGHIJKLMNOPQRSTUVWXYZ",

"abcdefghijklmnopqrstuvwxyz");

Errors:

TPU$_CONTROLC Execution aborted by [CTRL-C].

TPU$_NOTMODIFIABLE Current buffer is READ_ONLY.