KPG1_GTCHV

Obtains a vector of choices from the environment

Description:

This routine gets NVAL strings from the user, selected from those supplied in OPTS. The indices of the supplied strings within OPTS are returned. The user supplies the strings in the form of a GRP group expression, using the default GRP control characters.

The user may supply an integer value instead of a string, in which case the integer is understood to be the index of the required string within OPTS. If the supplied list of strings contains the integer itself, then the integer is understood to be a string, not an index.

Invocation

CALL KPG1_GTCHV( NOPT, OPTS, PARAM, NVAL, IDEF, VALS, STATUS )

Arguments

NOPT = INTEGER (Given)
The number of available options supplied in OPTS.
OPTS( NOPT ) = CHARACTER ∗ ( ∗ ) (Given)
An array holding the options from which the user must choose. Leading and trailing white space is ignored. Blank options are not allowed.
PARAM = CHARACTER ∗ ( ∗ ) (Given)
The name of the parameter to use.
NVAL = INTEGER (Given)
The number of choices required. The user must supply exactly this number of choices.
IDEF( NVAL ) = INTEGER (Given)
The indices within OPTS of the default strings to use if a null (!) value is supplied for the parameter. If the first value is zero, a null parameter value results in a PAR__NULL status being returned.
VALS( NVAL ) = INTEGER (Returned)
The indices within OPTS of the selected options.
STATUS = INTEGER (Given and Returned)
The global status.

Notes: