cdflib.inquireAttrgEntry

Information about entry in attribute with global scope

Syntax

[datatype,numElements] = cdflib.inquireAttrgEntry(cdfId,attrNum,entryNum)

Description

[datatype,numElements] = cdflib.inquireAttrgEntry(cdfId,attrNum,entryNum) returns the data type and the number of elements for a global attribute entry in a Common Data Format (CDF) file.

Input Arguments

cdfId

Identifier of a CDF file, returned by a call to cdflib.create or cdflib.open.

attrNum

Numeric value identifying an attribute in the file. Attribute numbers are zero-based. The attribute must have global scope.

entryNum

Numeric value identifying the entry in the attribute. Entry number are zero-based.

Output Arguments

datatype

Character vector identifying a CDF data type. For a list of CDF data types, see cdflib.putAttrgEntry

numElements

Numeric value indicating the number of elements in the entry.

Examples

Open the example CDF, and then get information about entries associated with a global attribute in the file.

cdfid = cdflib.open('example.cdf');

% Any of the first three attributes have global scope.
attrscope = cdflib.getAttrScope(cdfid,0)

attrscope =

GLOBAL_SCOPE

% Get information about the first entry for this attribute
[dtype numel] = cdflib.inquireAttrgEntry(cdfid,0,0)

dtype =

cdf_char


numel =

    23


% Clean up
cdflib.close(cdfid);

clear cdfid

References

This function corresponds to the CDF library C API routine CDFinquireAttrgEntry.

To use this function, you must be familiar with the CDF C interface. Read the CDF documentation at the CDF website.

For copyright information, see the cdfcopyright.txt file.