Previous: x/ zvparmd Up: Parameter Routines Next: x/ zvpstat
status = xvpone(name, value, instance, maxlen) status = zvpone(name, value, instance, maxlen);
This routine returns a single value from a multivalued parameter. It is most useful to get a string from a list of strings without having to mess with string arrays, but can be used for integer or real (single-precision) values as well. Note that xvpone is a Fortran function with a status return, which differs from most Fortran RTL routines.
NAME is the name of the parameter to get a value from.
The value of the parameter is returned in VALUE. The type of the value depends on the type of the parameter, which is either INTEGER, STRING, or REAL (single-precision). There is no equivalent to x/ zvpone for double precision floating point; use x/ zvparmd instead.
INSTANCE specifies which value you want. INSTANCE starts counting at 1, so the fifth value would have an INSTANCE of 5.
MAXLEN specifies the maximum length of the string buffer if the parameter is a string. It is used to avoid overflowing your buffer. If the parameter is not a string, or you don't care, set MAXLEN to 0. MAXLEN is rarely needed in Fortran, since string lengths are available from the strings themselves.