Encoding

User interface > Main menu > Menu: Options > Project options > Encoding

For the settings of this register page some restrictions have to be taken into account. The settings cannot be reproduced completely in the debug mode and the functions to write UTF-8 encoded output, only are implemented in the transformation manager of the TextTransformer and in command line tool and are not part of the code accompanying the Professional Version of the TextTransformer. This applies to the reading the files generally.

For the source text and the target text you can adjust the encoding independently:

ANSI-Text

UTF-8

You cannot use RedirectOutput, if UTF-8 options is set. By this option RedirectOutput will be performed already.

Further you can adjust for the input file and the destination file, in which mode they are opened:

Text mode

Binary mode

In the TextTransformer the mode has an effect on the treatment of line breaks:

In the text mode single linefeed characters '\n' are treated, as if they were combined with a carriage return character '\r' - as usual under windows -, i.e. they are expanded automatically to this double character "\r\n", when reading or writing a file.

Example:

After execution of the statement:

out << '\n';        or out << endl;

"\r\n" is written in the output text.

In the binary mode such a transformation isn't carried out. A Windows line break then must be written explicitly by:

out << "\r\n " or out << '\r' << endl;

The editor of the TextTransformer is not able to represent line breaks from simple linefeed characters. So in binary mode there can be a different recognition of line breaks in debug mode and by the execution of a project in the transformation-manager or the command line tool. (However, both types of line breaks can be recognized together by the token: "\r?\n". )

When reading of a binary file into the TextTransformer editor, at the first appearance of the null character '\0' the reading is interrupted, even if the end of file isn't reached yet. Pure binary files (e.g. pictures and music) cannot be edited therefore appropriately within the TextTransformer surface. It nevertheless is possible with the TextTransformer to develop programs for such a processing, which then are executed in the transformation manager, tetra_cl.exe or as exported code. The binary mode serves for it.

The text mood is recommended for the work on text files under Windows.

This page belongs to the TextTransformer Documentation