Next: , Previous: Groups, Up: Groups


3.1 Find a Group ID: nc_inq_ncid

Given an ncid and group name (NULL or "" gets root group), return ncid of the named group.

Usage

     int nc_inq_ncid(int ncid, const char *name, int *grp_ncid);
ncid
The group id for this operation.
name
A char array that holds the name of the desired group.
grp_ncid
An int pointer that will receive the group id, if the group is found.

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, child_ncid;
        char file[] = "nc4_test.nc";
     
        /* Open the file. */
        if ((res = nc_open(file, NC_NOWRITE, &root_ncid)))
           return res;
     
        /* Get the ncid of an existing group. */
        if ((res = nc_inq_ncid(root_ncid, "group1", &child_ncid)))
           return res;