Extracts sequential elements of a dynamic array.
||An expression that resolves to a dynamic array from which successive data values are to be extracted.
||A local variable used to receive an integer code for the dynamic array delimiter type. delimcode cannot be a global variable or a subscripted variable.
function efficiently extracts successive data values from a dynamic array. The extracted element value is returned. The delimiter type is placed in the delimcode
variable. The REMOVE
function operates on all dynamic array delimiter levels; in contrast, the REMOVE
statement operates on a specified delimiter level.
maintains an internal pointer so that repeated calls return successive element values. If REMOVE
is called after the last element value has been extracted, it returns the empty string.
statement, and REVREMOVE
statement all share the same character position pointer. It is incremented by Remove operations and decremented by Revremove operations.
integer code values are as follows:
||End of file
||@IM Item Mark CHAR(255)
||@FM Field Mark CHAR(254)
||@VM Value Mark CHAR(253)
||@SM Subvalue Mark CHAR(252)
||@TM Text Mark CHAR(251)
The following example successively extracts the first five elements from a dynamic array:
FOR x=1 TO 5
© 1997-2019 InterSystems Corporation, Cambridge, MA