HDF_VG_LONE

The HDF_VG_LONE function returns an array containing the IDs of all VGroups in a Hierarchical Data Format file that are not contained in another VGroup . If there are no lone VGroups , HDF_VG_LONE returns -1.

Calling Sequence

Result = HDF_VG_LONE( FileHandle )

Arguments

FileHandle

The HDF file handle returned by a previous call to HDF_OPEN.

Keywords

MAXSIZE

The maximum number of groups to return (the default is to return all lone VGroups). For example, to return no more than 12 VGroups, use the command:

X = HDF_VG_LONE(fid, MAX=12)

Example

X=HDF_VG_LONE(fid)

IF X(0) EQ-1 THEN $

   PRINT, "No Lone VGroups" ELSE PRINT, "Lone VGroups:", X