Previous: x/ zvparmd Up: Parameter Routines Next: x/ zvpstat

x/ zvpone

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.

Arguments:

• NAME: string, input

  NAME is the name of the parameter to get a value from.

• VALUE: parameter-value, output

  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: integer, input

  INSTANCE specifies which value you want. INSTANCE starts counting at 1, so the fifth value would have an INSTANCE of 5.

• MAXLEN: integer, input

  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.