engine:import:addstring
This is an old revision of the document!
AddString
Add a special string such as an exclusion or header string.
Phase
This instruction is used by the TapeTrack Import Engine.
Syntax
AddString(type, offset, filter);
string type;
integer offset;
string filter;
| Variable | Type | Description | Min Length | Max Length | Min Value | Max Value |
|---|---|---|---|---|---|---|
| type | String |
- HEADER A string that represents the first record of a heading section.
- EXCLUSION A string that represents the a record that should be excluded from all further processing (skipped).
- START A string that represents when processing should start. If there is no start string specified processing will start at the first record.
- END A string that represents when processing should temporarily stop. Processing will recommence at the next START record.
- TERMINATE A string that represents when processing should permanently stop. No processing will be done past this point, even if a START record is encountered.
|1|10|
| offset | Integer | The zero based offset within the record at which the filter should be applied. | 1 | 10 | -214748364 | 2147483647 |
| filter | String | A filter value for comparison with the processed string. | 1 | 256 |
Example
AddString: Define a header (ANSI page break) with 7 records, skip records not starting with an integer and terminate processing at the first blank record
| AddString(HEADER, 0, “1*”); |
| SetHeaderCount(7); |
| AddString(EXCLUSION, 0, “!([0-9]*”); |
| AddString(TERMINATE, 0, “ *”); |
engine/import/addstring.1583364266.txt.gz · Last modified: 2025/01/21 22:07 (external edit)