Previous: x/ zviparmd Up: Parameter Routines Next: x/ zvipstat
status = xvipone(name, value, instance, maxlen) status = zvipone(name, value, instance, maxlen);
Interactive version of x/ zvpone.
This routine returns a single value from a multivalued interactive 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 xvipone is a Fortran function with a status return, which differs from most Fortran RTL routines.
NAME is the name of the interactive 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/ zvipone for double precision floating point; use x/ zviparmd 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.