$ZORDER (legacy function)

Returns the full reference for the next array node subscript.

Synopsis

$ZORDER(variable)

Parameter

Argument	Description
variable	Name of a subscripted local or global variable, or the null string. It can be a value, a variable, or an expression.

Description

This page describes the legacy function $ZORDER. It is described here for compatibility with legacy applications. $ZORDER is identical to the $QUERY function. New programs should use $QUERY instead of $ZORDER.

$ZORDER returns the full reference for the next array node subscript that follows the node indicated by the variable parameter. The variable can be a local or global subscripted array node. The returned subscript is at the same level as the one for the specified variable. If there is no subsequent array node at the variable’s node level, $ZORDER returns the null string ("").

Notes

$ZORDER and the Naked Indicator

$ZORDER can be used with a naked global reference. If the naked indicator is undefined, $ZORDER generates a <NAKED> error. If the naked indicator references the last element in an array, $ZORDER generates an <UNDEFINED> error.

When you attempt to use the naked indicator after $ZORDER has generated an <UNDEFINED> error at the end of an array, the naked indicator references the last element in the array.