Skip to Main Content Skip to Search
Product Documentation

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_CHAR1 byte, signed character data type that maps to the MATLABchar class
CDF_INT11-byte, signed integer.
CDF_UCHAR1 byte, unsigned character data type that maps to the MATLABuint8 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 these functions, 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.

See Also

cdflib.getAttrEntry | cdflib.getAttrgEntry | cdflib.getConstantValue | cdflib.putAttrEntry

Tutorials

  


Free MATLAB Interactive Kit

Explore how to use MATLAB to make advancements in engineering and science.


Download free kit

Trials Available

Try the latest version of MATLAB and other MathWorks products.


Get trial software
 © 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS