Description:
Appends
an ID string to an input string given the contents of the environment variable specified by
ENV_NAME Allowed values of ENV_NAME are stored in OPTIONS and the corresponding
string stored in OPTION_STRINGS. Default is to go for the first entry in the IDSTRING
array. if the value of ENV_NAME is either not set or unrecognized.
Invocation
CALL
SCULIB_CONSTRUCT_OUT(IN_STRING, ENV_NAME, N_OPTIONS, OPTIONS, OPTION_STRINGS,
OUT_STRING, STATUS)
Arguments
IN_STRING = CHAR (Given)
Input string
ENV_NAME =
CHAR (Given)
Name of environment variable to examine for suffix preference
N_OPTIONS =
INTEGER (Given)
Number of suffix options
OPTIONS(N_OPTIONS) = CHAR (Given)
Names
of different options
OPTION_STRINGS(N_OPTIONS) = CHAR (Given)
Suffixes for
each option. If the string starts with a ’!’ the input string is chopped from the last ’_’
before adding the new string.
OUT_STRING = CHAR (Returned)
Input string with
suffix
STATUS = INTEGER (Given & Returned)
Global status
Copyright
Copyright
©1995,1996,1997,1998,1999 Particle Physics and Astronomy Research Council. All Rights Reserved.