The NCDF_DIMRENAME procedure renames an existing dimension in a NetCDF file which has been opened for writing. If the new name is longer than the old name, the NetCDF file must be in define mode. You cannot rename one dimension to have the same name as another dimension.

Examples


See NCDF_VARPUT.

Syntax


NCDF_DIMRENAME, Cdfid, Dimid, NewName

Arguments


Cdfid

The NetCDF ID, returned from a previous call to NCDF_OPEN, NCDF_CREATE, or NCDF_GROUPDEF.

Dimid

The NetCDF dimension ID, returned from a previous call to NCDF_DIMID or NCDF_DIMDEF, or the name of the dimension.

NewName

A scalar string containing the new name for the dimension.

Keywords


None

Version History


Pre 4.0

Introduced