cdflib.renameAttr

Rename existing attribute

Syntax

cdflib.renameAttr(cdfId,attrNum,newName)

Description

cdflib.renameAttr(cdfId,attrNum,newName) renames an attribute in a Common Data Format (CDF) file.

cdfId identifies the CDF file. attrNum is a numeric value that identifies the attribute. Attribute numbers are zero-based. newName is a character vector or string scalar that specifies the name you want to assign to the attribute.

Examples

Create a CDF, create an attribute in the CDF, and then rename the attribute. To run this example, you must be in a writable folder.

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

% Create an attribute
attrNum = cdflib.createAttr(cdfid,'Purpose','global_scope');

% Rename the attribute
cdflib.renameAttr(cdfid, attrNum,'NewPurpose');

% Check the name of the attribute
attrName = cdflib.getAttrName(cdfid,anum)

attrName =

NewPurpose

% Clean up
cdflib.delete(cdfid);

clear cdfid

References

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

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.