+---------------------------------+
|             CHRTRAN             |
+---------------------------------+
CHRTRAN(<expC1>, <expC2>, <expC3>)

-----------------------------------
Translates characters of a character expression using two other
character expressions as translation tables.
Return value - Character
-----------------------------------

This function translates the characters of <expC1> using the strings
<expC2> and <expC3> as a translation table.  All occurrences of the
first character in <expC2> are replaced by the first character in
<expC3>, the second character in <expC2> by the second character in
<expC3> and so on.

<expC1>
        Expression to be translated.

<expC2>
        First translate table.

<expC3>
        Second translate table.  If <expC3> has fewer characters than <expC2>,
the additional characters in <expC2> are translated to null characters.
If <expC3> has more characters that <expC2>, the additional characters
are ignored.

+---------------------------------+
|             Examples            |
+---------------------------------+
? CHRTRAN('abcdef', 'ace', 'xyz')

? CHRTRAN('abcd', 'abc', 'yz')

? CHRTRAN('abcdef', 'ace', 'xyzqrst')

-----------------------------------

See Also:  SYS(15) Character translation

-----------------------------------