'''`[array] nextelement`''' retrieves the name of the
next matching variable in an array search



** Synopsis **


'''`[array] nextelement`''' ''`arrayName searchId`''



** Description **

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.''


<<categories>> Command | Tcl syntax