$QLENGTH

Returns the number of subscripts in the specified local or global variable.

Synopsis

$QLENGTH(namevalue)
$QL(namevalue)

Parameters

namevalue

A string, or expression that evaluates to a string, which is a local or global reference.

Description

$QLENGTH returns the number of subscripts in the local or global variable specified by namevalue.

Parameters

namevalue

A string, or expression that evaluates to a string, which is a local or global reference. If the string is a global reference, it can contain a namespace reference. It can have the form NAME(s1,s2,...,sn).

Example

The following example show the results of $QLENGTH when used with subscripted and unsubscripted globals. The first $QLENGTH$ returns 0. The second $QLENGTH returns 2.

   WRITE !,$QLENGTH("^|""USER""|%test")
   SET name="^|""USER""|%test(1,""customer"")"
   WRITE !,$QLENGTH(name)