4.6.2. Determining all entities in a file
[4.6. XMDF Groups]

Sometimes the program reading the XMDF file will have the path where data resides given to them. When we are not looking for a specific entity or don’t know the path for the group, the API provides the following functions to get paths to specific groups. These functions traverse the groups in the file and look for the Grouptype flags. The first function in each set is used to determine the required size of the character arrays that holds the paths. The path passed into the second function in each set must be allocated to a size Num*MaxSize. Data set groups beneath meshes or grids will not be returned and must be accessed through the mesh or grid to which they belong.

C/C++

int xfGetGroupPathsSizeForMeshes(xid FileId, int *Num, int *MaxSize);
int xfGetAllGroupPathsForMeshes(xid FileId, int Num, int MaxSize, char *path);
 
int xfGetGroupPathsSizeForGrids(xid FileId, int *Num, int *MaxSize);
int xfGetAllGroupPathsForGrids(xid FileId, int Num, int MaxSize, char *path);
 
int xfGetGroupPathsSizeForXsecs(xid FileId, int *Num, int *MaxSize);
int xfGetAllGroupPathsForXsecs(xid FileId, int Num, int MaxSize, char *path);

FORTRAN

SUBROUTINE XF_GRP_PTHS_SZ_FOR_MESHES (FileId, Num, Maxsize, Error)
INTEGER(XID), INTENT(IN) ::   FileId
INTEGER, INTENT(OUT) ::       Num, Maxsize, Error
 
SUBROUTINE XF_GET_GROUP_PATHS_FOR_MESHES (FileId, Num, Size, Paths, Error)
INTEGER(XID), INTENT(IN) ::     FileId
INTEGER, INTENT(IN) ::  Num, Size
CHARACTER(len=Size), DIMENSION(Size, Num), INTENT(INOUT) ::  Paths
INTEGER, INTENT(OUT) :: Error
 
 
SUBROUTINE XF_GRP_PTHS_SZ_FOR_GRIDS (FileId, Num, Maxsize, Error)
INTEGER(XID), INTENT(IN) ::   FileId
INTEGER, INTENT(OUT) ::       Num, Maxsize, Error
 
SUBROUTINE XF_GET_GROUP_PATHS_FOR_GRIDS (FileId, Num, Size, Paths, Error)
INTEGER(XID), INTENT(IN) ::     FileId
INTEGER, INTENT(IN) ::  Num, Size
CHARACTER(len=Size), DIMENSION(Size, Num), INTENT(INOUT) ::  Paths
INTEGER, INTENT(OUT) :: Error
 
SUBROUTINE XF_GRP_PTHS_SZ_FOR_XSECS (FileId, Num, Maxsize, Error)
INTEGER(XID), INTENT(IN) ::   FileId
INTEGER, INTENT(OUT) ::       Num, Maxsize, Error
 
SUBROUTINE XF_GET_GROUP_PATHS_FOR_XSECS (FileId, Num, Size, Paths, Error)
INTEGER(XID), INTENT(IN) ::     FileId
INTEGER, INTENT(IN) ::  Num, Size
CHARACTER(len=Size), DIMENSION(Size, Num), INTENT(INOUT) ::  Paths
INTEGER, INTENT(OUT) :: Error