Next: , Previous: NF90_INQ_GRPNAME, Up: Groups


3.7 Find a Group's Full Name: NF90_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 NF90_INQ_GRPNAME.

To find the length of the full name See NF90_INQ_GRPNAME_LEN.

Usage

       function nf90_inq_grpname_full(ncid, len, name)
         integer, intent(in) :: ncid
         integer, intent(out) :: len
         character (len = *), intent(out) :: name
         integer :: nf90_inq_grpname_full
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

NF90_NOERR
No error.
NF90_EBADID
Bad group id.
NF90_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 NF90_OPEN).
NF90_ESTRICTNC3
This file was created with the strict netcdf-3 flag, therefore netcdf-4 operations are not allowed. (see NF90_OPEN).
NF90_EHDFERR
An error was reported by the HDF5 layer.

Example

This example is from test program nf_test/f90tst_grps.f90.

       call check(nf90_inq_grpname_full(grpid1, len, name_in))
       if (name_in .ne. grp1_full_name) stop 62