Description

Extracts substrings, including fields, values, and subvalues, from dynamic binary arrays, using ANSI characters 249 through 255 as delimiters.

Syntax

BRemove variable From string At column Setting flag

Parameters

The BRemove statement has the following parameters.

ParameterDescription
variable, stringVariable will contain the substring that is extracted from string.
ColumnIndicates the starting position of the string to be extracted. It is important to note that the Remove statement changes the column to point to the start of the next substring. The end of the substring occurs when an ANSI character from 249 to 255 is encountered.
Flag

Set with the following values, according to the delimiter found:

ValueMeaning
0End of string.
1Record mark ASCII character 255.
2Field mark ASCII character 254.
3Value mark ASCII character 253.
4Subvalue mark ASCII character 252.
5Text mark ASCII character 251.
6ASCII character 250.
7ASCII character 249.

Remove extracts data from a long string faster and more efficiently than does Extract, if doing sequential access through the array.

See also

ExtractRemove statement

Example

/* This code segment demonstrates the fastest way to sequentially access each element of a dynamic array. */
dyn_array = "123": @FM: "678": @FM: "ABC"
position = 1
flag  = ""
Loop
    BRemove current_element From dyn_array At position Setting flag
While flag
Repeat
  • No labels