array nextelement

array nextelement retrieves the name of the next matching variable in an array search


array nextelement arrayName searchId


Returns the name of the next matching variable in arrayName, or an empty string if all variables in 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 variables 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.