basic.remove Statement/BASIC Program

basic.remove

Command basic.remove Statement/BASIC Program
Applicable release versions: AP 6.2, R91
Category BASIC Program (486)
Description removes a substring delimited by a system delimiter from a dynamic array.

Before the initial call, position.variable must be set to zero. The variable is updated with the end of the current substring at the end of every call.

The delemiter.variable is updated with the code indicating imiter found at the end of the substring returned. The code is one of the following:

0 = end of string
2 = attribute mark - ASCII char(254)
3 = value mark - ASCII char(253)
4 = subvalue mark - ASCII char(252)
5 = char(251)
6 = char(250)
Syntax remove variable from dynamic.array at position.variable setting delimiter.variable
Options
Example
x = "a":@am:"b":@vm:"c"
l = 0
remove xx from x at l setting d
print xx,l,d
remove xx from x at l setting d
print xx,l,d
remove xx from x at l setting d
print xx,l,d

This will print the following result:
a      2       2
b      3       3
c      5      0
Purpose
Related basic.array.dynamic