Routines (alphabetical) > Routines: C > CDF Routines > CDF_VARPUT

# 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