CDF_VARPUT
==========

The CDF_VARPUT procedure writes a value to a variable in a Common Data Format 
file. This function provides equivalent functionality to the C routines 
CDFvarPut and CDFvarHyperPut.

Examples

id= CDF_CREATE('mycdf', [5,10], /NETWORK_ENCODING, /ROW_MAJOR)

varid= CDF_VARCREATE(id, 'V1', [1,1], /CDF_FLOAT, /REC_VARY)

To write the value 42.0 into record 12, third row, fourth column:

CDF_VARPUT, id, varid, 42, REC_START=12, OFFSET=[2,3]

Syntax

CDF_VARPUT, Id, Variable, Value [, COUNT=vector] [, INTERVAL=vector] $
                                [, OFFSET=vector] [, REC_INTERVAL=value] $
                                [, REC_START=record] [, /ZVARIABLE]

Arguments

Id

The CDF ID, returned from a previous call to CDF_OPEN or CDF_CREATE.

Variable

A string containing the name or number of the variable being written.

Value

The value to write. If the value has 1 more dimension than the CDF, multiple 
records will be written.

Keywords

COUNT

An optional vector containing the counts to be used in writing Value. Note that 
counts do not have to match the dimensions of Value. The default count is to 
use the dimensions of Value.

INTERVAL

A vector specifying the interval between values in each dimension. The default 
value is 1 in each dimension.

OFFSET

A vector specifying the array indices within the specified record(s) at which 
to begin writing. OFFSET is a 1-dimensional array containing one element per 
CDF dimension. The default value is zero in each dimension.

REC_INTERVAL

The interval between records being written when writing multiple records. The 
default value is 1.

REC_START

The record number at which to start writing. The default is 0.

ZVARIABLE

If Variable is a variable ID (as opposed to a variable name) and the variable 
is a zVariable, set this flag to indicate that the variable ID is a zVariable 
ID. The default is to assume that Variable is an rVariable ID.

Version History

Pre 4.0

Introduced

See Also

CDF_VARCREATE, CDF_VARINQ, CDF_VARGET

© 2015 Exelis Visual Information Solutions, Inc., a subsidiary of Harris 
Corporation. All Rights Reserved. This information is not subject to the 
controls of the International Traffic in Arms Regulations (ITAR) or the Export 
Administration Regulations (EAR). However, this information may be restricted 
from transfer to various embargoed countries under U.S. laws and regulations.