CDF_VARINQ
==========

The CDF_VARINQ function returns a structure containing information about the 
specified variable in a Common Data Format file.

Examples

See the example for CDF_VARGET.

Syntax

Result = CDF_VARINQ( Id, Variable [, /ZVARIABLE] )

Return Value

The returned structure has the form:

{ IS_ZVAR:0, NAME:"", DATATYPE:"", NUMELEM:0L, $

   RECVAR:"", DIMVAR:BYTARR(...) [, DIM:LONARR(...)]}

Note: The DIM field is included in the structure only if IS_ZVAR is one.

Explanation of the Structure Tags

The following table provides structure tag information.

Tag

Description

IS_ZVAR

This field will contain a 1 if the variable is a zVariable or a 0 if it is an 
rVariable.

NAME

The name of the variable.

DATATYPE

A string describing the data type of the variable. The string has the form 
‘CDF_XXX’ where XXX is FLOAT, DOUBLE, EPOCH, UCHAR, etc.

NUMELEM

The number of elements of the data type at each variable value. This is always 
1 except in the case of string type variables (CDF_CHAR, CDF_UCHAR).

RECVAR

A string describing the record variance of the variable. This is either the 
string ‘VARY’ or ‘NOVARY’.

DIMVAR

An array of bytes. The value of each element is zero if there is no variance 
with that dimension and one if there is variance. For zero-dimensional CDFs, 
DIMVAR will have one element whose value is zero.

DIM

An array of longs. The value of each element corresponds to the dimension of 
the variable. This field is only included in the structure if the variable is 
a zVariable.

Arguments

Id

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

Variable

A string containing the name or an integer containing the index of the variable 
being inquired.

Keywords

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

© 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.