TRANSLATE

    Substitutes one set of specified characters for another set in text.
    Invokes the RTL procedure STR$TRANSLATE to replace one or more
    characters.  For more information, see the VMS System Routines volumes.

 Syntax

    TRANSLATE ({string1 | range | buffer}, string2 , string3)

 Parameters

    string1    A string in which one or more characters are to be replaced.
               String constants cannot be translated.

    range      A range in which one or more characters are to be replaced.

    buffer     A buffer in which one or more characters are to be replaced.

    string2    The string of replacement characters.

    string3    The literal characters within the text specified by
               parameter1 that are to be replaced.

 Comments

    TRANSLATE searches the text specified by parameter1 for the characters
    specified by parameter3.  When a character specified by parameter3 is
    found, the character at the same string offset in parameter2 is
    substituted into the text.

 Example

    TRANSLATE (main_buffer, "X", "x");

    Replaces all lowercase x's in the main buffer with uppercase X's.