cdflib.putAttrEntry

Write value to entry in attribute with variable scope

Syntax

cdflib.putAttrEntry(cdfId,attrNum,entryNum,CDFDataType,entryVal)

Description

cdflib.putAttrEntry(cdfId,attrNum,entryNum,CDFDataType,entryVal) writes a value to an 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. The attribute must have variable scope. Attribute numbers are zero-based.

entryNum

Number identifying entry. Entry numbers are zero-based.

CDFdatatype

Data type of the attribute entry, specified as one of the following character vectors or string scalars, or its numeric equivalent.

CDF Data Type	MATLAB^® Equivalent
`'CDF_BYTE'`	1-byte, signed integer
`'CDF_CHAR'`	1 byte, signed character data type that maps to the MATLAB `char` or `string` class
`'CDF_INT1'`	1-byte, signed integer.
`'CDF_UCHAR'`	1 byte, unsigned character data type that maps to the MATLAB `uint8` class
`'CDF_UINT1'`	1-byte, unsigned integer
`'CDF_INT2'`	2-byte, signed integer
`'CDF_UINT2'`	2-byte, unsigned integer.
`'CDF_INT4'`	4-byte, signed integer
`'CDF_UINT4'`	4-byte, unsigned integer
`'CDF_FLOAT'`	4-byte, floating point
`'CDF_REAL4'`	4-byte, floating point
`'CDF_REAL8'`	8-byte, floating point.
`'CDF_DOUBLE'`	8-byte, floating point
`'CDF_EPOCH'`	8-byte, floating point
`'CDF_EPOCH16'`	two 8-byte, floating point

entryVal

Data to be written to attribute entry.

Examples

Create a CDF and create an attribute with variable scope 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 global or variable attributes
info = cdflib.inquire(cdfId)

info = 

  struct with fields:

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

% Create an attribute of variable scope in the file
attrNum = cdflib.createAttr(cdfId,"Another Attribute","variable_scope");

% Write a value to an entry for the attribute
cdflib.putAttrEntry(cdfId,attrNum,0,"CDF_CHAR",...
                    "My Variable Attribute Test")

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

value =

    'My Variable Attribute Test'

% Clean up
cdflib.delete(cdfId)
clear cdfId

Tips

This function corresponds to the CDF library C API routine CDFputAttrzEntry.
To use this function, you must be familiar with the CDF C interface. You can access the CDF documentation at the CDF website.