Main Content

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");

% All 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. You can access the CDF documentation at the CDF website.

Version History

expand all