netcdf.inqGrpNameFull

Complete pathname of group

Syntax

groupName = netcdf.inqGrpNameFull(ncid)

Description

groupName = netcdf.inqGrpNameFull(ncid) returns the complete pathname of the group specified by ncid.

Input Arguments

ncid

Identifier of NetCDF file, returned by netcdf.create or netcdf.open, or of a NetCDF group, returned by netcdf.defGrp.

Output Arguments

groupName

Text string specifying complete path of group.

The root group has the name '/'. The names of parent groups and child groups use the forward slash '/' separator, as in UNIX folder names, for example, /group1/subgrp2/subsubgrp3.

Examples

Open the NetCDF sample dataset and retrieve the names of all groups.

ncid = netcdf.open('example.nc','NOWRITE');
gid = netcdf.inqNcid(ncid,'grid2');
fullName = netcdf.inqGrpNameFull(gid);
netcdf.close(ncid);

References

This function corresponds to the nc_inq_grpname_full function in the netCDF library C API.

For copyright information, read the netcdfcopyright.txt and mexnccopyright.txt files.

Was this topic helpful?