SCULIB_CONSTRUCT_OUT - Append a identification string to a string

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.