NF_INQ_GRP_FULL_NCID - NetCDF Fortran 77 Interface Guide

Next: NF_DEF_GRP, Previous: NF_INQ_GRP_NCID, Up: Groups

3.10 Find a Group by its Fully-qualified Name: NF_INQ_GRP_FULL_NCID

Given a fully qualified group name an an ncid, find the ncid of the group id.

Usage

     INTEGER FUNCTION NF_INQ_GRP_FULL_NCID(INTEGER NCID, CHARACTER FULL_NAME, INTEGER GRP_NCID)

NCID: The group id to look in.
FULL_NAME: The fully-qualified group name.
GRP_NCID: This will get the group id, if it is found.

Return Codes

The following return codes may be returned by this function.

NF_NOERR: No error.
NF_EBADID: Bad group id.
NF_EINVAL: No name provided or name longer than NF_MAX_NAME.
NF_ENOGRP: Named group not found.
NF_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 NF_OPEN).
NF_ESTRICTNC3: This file was created with the strict netcdf-3 flag, therefore netcdf-4 operations are not allowed. (see NF_OPEN).
NF_EHDFERR: An error was reported by the HDF5 layer.

Example

This example is from nf_test/ftst_groups.F.

     C     Check the full name of the root group (also "/").
           retval = nf_inq_grpname_full(ncid, full_name_len, name_in)
           if (retval .ne. nf_noerr) call handle_err(retval)