5.8 Inserting a Field into a Compound Type: nc_insert_compound
Insert a named field into a compound type.
Usage
int nc_insert_compound(int ncid, nc_type typeid, const char *name, size_t offset,
nc_type field_typeid);
ncid
- The groupid where a field for this compound type will be inserted.
typeid
- The typeid for this compound type, as returned by nc_def_compound, or
nc_inq_var.
name
- The name of the new field.
offset
- Offset in byte from the beginning of the compound type for this
field.
field_typeid
- The type of the field to be inserted.
Errors
NC_NOERR
- No error.
NC_EBADID
- Bad group id.
NC_ENAMEINUSE
- That name is in use. Field names must be unique within a compound type.
NC_EMAXNAME
- Name exceed max length NC_MAX_NAME.
NC_EBADNAME
- Name contains illegal characters.
NC_ENOTNC4
- Attempting a netCDF-4 operation on a netCDF-3 file. NetCDF-4
operations can only be performed on files defined with a create mode
which includes flag NC_NETCDF4. (see nc_open).
NC_ESTRICTNC3
- This file was created with the strict netcdf-3 flag, therefore
netcdf-4 operations are not allowed. (see nc_open).
NC_EHDFERR
- An error was reported by the HDF5 layer.
NC_ENOTINDEFINE
- Not in define mode.
Example