Caché ObjectScript Reference - InterSystems Documentation

$NEXT$NEXTReturns the value of the next subscript in a subscripted variable.$NEXT(variable)$N(variable)ParametersvariableThe array subscript to be used to determine the next existing subscriptvalue.Description$NEXT returns the value of the next subscript in the subscripted variable. It can be either alocal or global subscripted array element. The value of the rightmost subscript must be anumber whose value is -1 or greater. If you are using a naked global reference, the nakedindicator must be defined.$NEXT is an obsolete function that has been superseded by the $ORDER function. It isdocumented here only for completeness.Note:Do not use $NEXT in any new code. Use $ORDER in place of $NEXT to retrievesubscripts of an array.Notes$NEXT and $ORDER$NEXT is similar to $ORDER. Both return the subscripts of the next sibling in collatingorder to the specified node. However, $NEXT and $ORDER have different start and failurecodes, as follows:Starting pointFailure code$NEXT-1-1$ORDERNull stringNull StringSee Also$ORDER functionCaché ObjectScript Reference 267