documentation of dim rename for netcdf-4 vs classic

This commit is contained in:
Ed Hartnett 2019-02-25 07:32:06 -07:00
parent fba4c19953
commit f83c8a5d3a

View File

@ -233,11 +233,14 @@ nc_inq_dim(int ncid, int dimid, char *name, size_t *lenp)
for writing. You cannot rename a dimension to have the same name as
another dimension.
For netCDF classic and 64-bit offset files, if the new name is longer
than the old name, the netCDF dataset must be in define mode.
For netCDF classic and 64-bit offset files, if the new name is
longer than the old name, which has been flushed to disk, the
netCDF dataset must be in define mode.
For netCDF-4 files the dataset is switched to define mode for the
rename, regardless of the name length.
For netCDF-4 files the length of the name is not checked against
the length of the old name, even for classic model files. This is
due to the difficulty of exactly reproducing classic library
behavior in this case.
@param ncid NetCDF or group ID, from a previous call to nc_open(),
nc_create(), nc_def_grp(), or associated inquiry functions such as