nc_attputΒΆ
nc_attput changes a variable attribute or global attribute of an open nc file. If the attribute is new, or if the space required to store the attribute is greater than before, the nc file must be in define mode.
-
r = nc_attput(ncid, varid, ssName, nDataType, values) -
r = nc_attput(ncid, varid, ssName, nDataType, values, bOverwrite)
Return Value
r is -1, if an error occurred.
Parameters
-
ncid Identifies the netCDF file.
-
varid varid is the variable ID of the variable to which the attribute will be assigned or -1 for a global attribute. The variable ID starts with 0.
-
ssName ssName is the name of the attribute. It must begin with an alphabetic character, followed by zero or more alphanumeric characters including the underscore (
_). Case is significant.
-
nDataType nDataType is the data type of the attribute. The valid netCDF data types are:
Value Meaning NC_BYTE Eight-bit data NC_CHAR for representing text strings as arrays of ASCII characters NC_SHORT 16-Bit integers NC_LONG 32-Bit integers NC_FLOAT 32-Bit IEEE floating-point NC_DOUBLE 64-Bit IEEE floating-point
-
values values is the data value of the appropriate type. values can be a column or row vector.
-
bOverwrite If bOverwrite is set to TRUE (1) the attribute value will be overwritten. If bOverwrite is set to FALSE (0), a new attribute will be created (Default). A unique name will be created by adding a number to the attribute name.
Comment
File must be in definition mode (see:ref:nc_redef).
See also
id-550528