Test -translation utility

Test charset translation.

Syntax
imsimta test -translation &#x5b;input-string&#x5d;

input-string
Input string to try translating to an alternate charset.

Description
The  utility allows testing  charset translation. Note that this is not language translation; rather, it is conversion of the representation of  characters, from one charset representation, into another charset  representation.

Specify the compiled charset data image file. By default, the image file used is    (prior to MS 7.0, the file named by the   MTA Tailor option).

Specify a source charset: the charset used in the input string.

Specify a destination charset: the charset to use in the output string.

Read input from the specified file.

Direct output to the specified file.

,  (default)
When translating from one charset to another charset that does not have the actual character, but does have the character sans accent,  specifying   causes the accentless character  to be output; effectively it "strips" accents. So for instance,   may be useful when desiring to  downgrade a charset such as ISO-8859-1 down to US-ASCII.

,  (default)
Specifies whether or not the state of the charset converter is reset prior to each call.

,  (default)
Specifying  tells the utility to generate and  output the entire charset table for converting from UTF-8 to the  specified output charset. Specifying  implies. (Thus note that in particular,   and     cannot both be specified; and while some input file or string can be  specified, it will be ignored.)

,  (default)
Specifies whether or not mnemonics can be used to enter non-US-ASCII characters.

,  (default)
Specifies whether or not escape sequences can be used to enter UTF-8 characters.

Examples
The above example shows a command line for translating the source file   which is in the UTF-8 charset, into the  destination file   which is in the KOI8-R charset. U=V=E=L=I=C%I=T=%" P=R=O=D=A=Z%I= "Converting" text to US-ASCII, when the original text contained characters not present in the US-ASCII charset, results in  outputting the mnemonics (as defined in  ) for  the "missing" characters. The above example shows outputting  the character mnemonics corresponding to two (Russian language) words,  originally represented in the KOI8-R charset; in this case, the output consists of mnemonics  for a number of Cyrillic characters.
 * 1) imsimta test -translation -source=utf-8 -input=utf8.txt -destination=koi8-r -output=koi8r.txt
 * 1) imsimta test -translation -source=koi8-r -destination=us-ascii -input=koi8r.txt -output=mnemonicized.txt
 * 2) cat mnemonicized.txt

See also:
 * MTA command line utilities