cdflib.putAttrgEntry

Write value to entry in attribute with global scope

Syntax

cdflib.putAttrgEntry(cdfId,attrNum,entryNum,cdfDataType,entryVal)

Description

cdflib.putAttrgEntry(cdfId,attrNum,entryNum,cdfDataType,entryVal) writes a value to 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

Number identifying attribute. Attribute numbers are zero-based. The attribute must have global scope.

entryNum

Number identifying entry. Entry numbers are zero-based.

CDFdatatype

One of the following text strings that specify the data type of the attribute entry, or its numeric equivalent.

CDF Data TypeMATLAB® Equivalent
CDF_BYTE1-byte, signed integer
CDF_CHAR

1 byte, signed character data type that maps to the MATLAB char class

CDF_INT11-byte, signed integer.
CDF_UCHAR

1 byte, unsigned character data type that maps to the MATLAB uint8 class

CDF_UINT11-byte, unsigned integer
CDF_INT22-byte, signed integer
CDF_UINT22-byte, unsigned integer.
CDF_INT44-byte, signed integer
CDF_UINT44-byte, unsigned integer
CDF_FLOAT4-byte, floating point
CDF_REAL44-byte, floating point
CDF_REAL88-byte, floating point.
CDF_DOUBLE8-byte, floating point
CDF_EPOCH8-byte, floating point
CDF_EPOCH16two 8-byte, floating point

entryVal

Data to be written to global attribute entry.

Examples

Create a CDF and create a global attribute in the file. Write a value to an entry in the attribute. To run this example, you must be in a writable folder.

cdfid = cdflib.create('your_file.cdf');

% Initially the file contains no attributes, global or variable.
info = cdflib.inquire(cdfid)

info = 

     encoding: 'IBMPC_ENCODING'
     majority: 'ROW_MAJOR'
       maxRec: -1
      numVars: 0
    numvAttrs: 0
    numgAttrs: 0

% Create a global attribute in the file.
attrNum = cdflib.createAttr(cdfid,'Purpose','global_scope');

% Write a value to an entry for the global attribute
cdflib.putAttrgEntry(cdfid,attrNum,0,'CDF_CHAR','My Test');

% Get the value of the global attribute entry
value = cdflib.getAttrgEntry(cdfid,attrNum,0)

value =

My Test

% Clean up
cdflib.delete(cdfid);

clear cdfid

References

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

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

For copyright information, see the cdfcopyright.txt file.

Was this topic helpful?