Updated 2015-03-06 22:19:05 by AMG

array nextelement arrayName searchId

Returns the name of the next element in arrayName, or an empty string if all elements of arrayName have already been returned in this search. The searchId argument identifies the search, and must have been the return value of an array startsearch command. Warning: if elements are added to or deleted from the array, then all searches are automatically terminated just as if array donesearch had been invoked; this will cause array nextelement operations to fail for those searches.

This command should be considered to be deprecated. It is still supported in 8.6, but will probably be culled in 9.0.

See also: