Description:
The names with indices between INDEX
and INDEX
SIZE-1
(inclusive) contained in the given group are returned. An error is reported if the bounds of the
group are exceeded, and STATUS is returned equal to GRP__OUTBN. If the group is case
insensitive (as established by a call to
GRP_SETCS) then the names are converted to upper case
before being returned.
Invocation
CALL GRP_GET( IGRP, INDEX, SIZE, NAMES, STATUS
)
Arguments
IGRP = INTEGER (Given)
A GRP identifier for the group.
INDEX =
INTEGER (Given)
The lowest index for which the corresponding name is required.
SIZE =
INTEGER (Given)
The number of names required.
NAMES( SIZE ) = CHARACTER
(
)
(Returned)
The names held at the given positions in the group. The corresponding character
variables should have declared length specified by the symbolic constant GRP__SZNAM. If the
declared length is shorter than this, the returned names may be truncated, but no error is reported.
STATUS = INTEGER (Given and Returned)
The global status.