3.4 Find all Dimensions Visible in a Group: nc_inq_dimids
Find all dimids for a location. This finds all dimensions in a group,
or any of its parents.
Usage
int nc_inq_dimids(int ncid, int *dimids);
ncid- The group id for this operation.
dimids- An already allocated array of ints when the dimids of the visible
dimensions will be stashed. Use nc_inq_ndims to find out how many dims
are visible from this group. (see nc_inq Family).
Errors
NC_NOERR- No error.
NC_EBADID- Bad group id.
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 HDF5. (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.
Example
int root_ncid, numdims;
int *dimids;
char file[] = "nc4_test.nc";
/* Open the file. */
if ((res = nc_open(file, NC_NOWRITE, &root_ncid)))
return res;
/* Get a list of dimids for the root group. (That is, find out of
there are any groups already defined. */
if ((res = nc_inq_ndims(root_ncid, &numdims)))
return res;
dimids = malloc(sizeof(int) * numdims);
if ((res = nc_inq_grps(root_ncid, NULL, dimids)))
return res;