NAME

vstor - task for temporary storage of command-line variables

USAGE

vstor

PARAMETERS

ival1 = 0 through ival4 = 0

Integer valued variables 1 through 4

rval1 = 0. through rval4 = 0.

Real valued variables 1 through 4

cval1 = "" through cval4 = ""

String valued variables 1 through 4

bval1 = yes through bval4 = yes

Boolean valued variables 1 through 4

DESCRIPTION

Dummy task to store command line variables for later re-use. The number of variables per type is currently limited to 4. For types int, real, and string this task therefore expands the total number of variables that are available to the user from the CL at any time to 7 (remember that i, j, k [int]; x, y, z [real]; and s1, s2, s3 [string] are pre-defined in the CL).

EXAMPLES

1. Store the result of a (possibly lengthy) numerical evaluation:

    rj> iwc ("spectra.lis")
    rj> vstor (ival1=122*(1+int((iwc.nlines-1)/29.))

2. Store and re-use result parameters of other tasks:

    rj> cparse ("image  =NGC4594B.fits[real]", delim="[", nsel=1, verbose-)
    rj> vstor (cval1=substr(cparse.cfield,9,strlen(cparse.cfield)))
    rj> rpbuild (1, 1024, vstor.ival1, vstor.ival1, pln=0)
    rj> vstor (cval2=rpbuild.imrpstr)
            ...
        (other calls to 'cparse' and/or 'rpbuild' will
        cause their task parameter values to change and
	the original values to be lost)
            ...
    rj> imstat (vstor.cval1//vstor.cval2)

REVISIONS

VSTOR v2.11, Apr 10 2001 [R.A. Jansen]

Original version of this task; IRAF 2.11.3

VSTOR v2.12, Aug 5 2003 [RAJ]

Added boolean variables; wrote this help file; IRAF 2.12.1

BUGS

SEE ALSO