The CharacterMap( from, to, s ) function transliterates the characters in the string s. A pair of strings, from and to, of equal length must be specified. Characters that appear in the first string (from) are mapped to the corresponding character in the second string (to).

A string is returned that is obtained from string s by replacing each occurrence of the character from[i] in s with the character to[i], for each i.

This function is part of the StringTools package, and so it can be used in the form CharacterMap(..) only after executing the command with(StringTools). However, it can always be accessed through the long form of the command by using the form StringTools[CharacterMap](..).

All of the StringTools package commands treat strings as (null-terminated) sequences of $8$-bit (ASCII) characters.  Thus, there is no support for multibyte character encodings, such as unicode encodings.

$\mathrm{with}\left(\mathrm{StringTools}\right)\:$

$\mathrm{CharacterMap}\left(''''\,'':''\,''This\; is\; a\; test''\right)$

$''This:is:a:test''$

$\mathrm{CharacterMap}\left(''aeiou''\,''AEIOU''\,''This\; is\; a\; test.''\right)$

$''ThIs\; Is\; A\; tEst.''$