TACL Reference Manual

Built-In Functions and Variables

HP NonStop TACL Reference Manual—429513-018

9-413

#VARIABLEINFO Built-In Function

Use #VARIABLEINFO to obtain information about a variable level.

option

specifies the type of information requested; it can be any of these:

DEPTH

returns the total number of levels for the specified variable.

DIRECTORY

returns the full name of the directory that contains the specified variable.

EXISTENCE

returns -1 if the variable level exists, 0 otherwise.

FRAME

returns the frame number of the specified variable.

LEN

returns the length of the specified variable level, as modified by its type.

LEVEL

returns the absolute number of the specified variable level. If you do not

specify a level number, the absolute number of the top level is given.

LINES

returns a line count for the specified variable level, as modified by its type.

MODE

returns the I/O mode, if any, of the specified variable level. The I/O modes are

IN, DYNAMIC_IN, OUT, STATUS, PROMPT, READ, WRITE, and ERROR.

If the variable level is a directory whose variables are in a different segment file

from that in which the directory resides, MODE returns the access mode to that

segment file, PRIVATE or SHARED.

OCCURS

returns the number of occurrences of characters, substructures, or simple

items within the specified variable level, depending on its type.

#VARIABLEINFO / option [ , option ] ... / variable-level