Escape Sequences

Using escape sequences in data field values.

Overview

By default TFORMer uses DataField values exactly as provided by the DataSource. No escape sequence handling will be performed. In some cases (e.g. when using non-printable characters) it may be required to pass such values as escape sequence to TFORMer SDK.

To specify if escape sequences in DataField values should be translated into their corresponding binary representation use TFormer_SetHandleEscapeSequences.

Supported Escape Sequences

Each escape sequence begins with a leading backslash. The following escape sequences are supported by TFORMer:

Escape Sequence	Character
\'	Single quotation mark
\"	Double quotation mark
\\	Backslash
\b	Backspace
\f	Form feed
\n	New line
\r	Carriage return
\t	Horizontal tab
\ddd	Octal sequence (3 digits: ddd)
\xdd	Hexadecimal sequence (2 digits: dd)
\udddd	Unicode sequence (4 hex digits: dddd) Not implemented in this version.

Invalid Escape Sequences

In case of an invalid escape sequence (e.g. \q, \999, \129, \xgg) the backslash is ignored. No error will be raised.

Invalid Escape Sequence in Data	Result
\q	q
\999	999
\609	09
\xgg	xgg
\	Empty string