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

# CDF_VARNUM

The CDF_VARNUM function returns the variable number associated with a given variable name in a Common Data Format file.

## Examples

See the example for CDF_VARGET.

## Syntax

Result = CDF_VARNUM( Id, VarName [, IsZVar] )

## Return Value

Returns the variable number of a specified variable name. If the specified variable cannot be found in the CDF file, CDF_VARNUM returns the scalar -1.

## Arguments

### Id

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

### VarName

A string containing the name of the variable.

### IsZVar

A named variable into which CDF_VARNUM will place a 1 to indicate that the referenced variable is a zVariable or a 0 to indicate that it is an rVariable.

## Keywords

None

## Version History

Pre 4.0 | Introduced