Next: , Previous: NF_INQ_GRPNAME, Up: Groups


3.7 Find a Group's Full Name: NF_INQ_GRPNAME_FULL

Given ncid, find complete name of group. (Root group is named "/").

The name provided by this function is a full path name for the group is, with all parent groups included, separated with a forward slash (as in Unix directory names). For a name relative to the parent group See NF_INQ_GRPNAME.

To find the length of the full name See NF_INQ_GRPNAME_LEN.

Usage

     INTEGER FUNCTION NF_INQ_GRPNAME_FULL(INTEGER NCID, INTEGER LEN, CHARACTER*(*) NAME)
NCID
The group id for this operation.
LEN
The length of the full group name will go here.
NAME
The name of the group will be copied to this character array.

Errors

NF_NOERR
No error.
NF_EBADID
Bad group id.
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.
           retval = nf_inq_grpname_full(grpids(1), full_name_len, name_in2)
           if (retval .ne. nf_noerr) call handle_err(retval)