Scotch Brand 5.1.10 - Manual (Page 96)

Return values
SCOTCH meshInit returns 0 if the mesh structure has been successfully ini-
tialized, and 1 else.
7.8.2 SCOTCH meshExit
Synopsis
void SCOTCH meshExit (SCOTCH Mesh * meshptr)
scotchfmeshexit (doubleprecision (*) meshdat)
Description
The SCOTCH meshExit function frees the contents of a SCOTCH Mesh structure
previously initialized by SCOTCH meshInit. All subsequent calls to SCOTCH
mesh*
routines other than SCOTCH meshInit, using this structure as parame-
ter, may yield unpredictable results.
7.8.3 SCOTCH meshLoad
Synopsis
int SCOTCH meshLoad (SCOTCH Mesh * meshptr,
FILE * stream,
SCOTCH Num baseval)
scotchfmeshload (doubleprecision (*) meshdat,
integer fildes,
integer*num baseval,
integer ierr)
Description
The SCOTCH meshLoad routine fills the SCOTCH Mesh structure pointed to by
meshptr
with the source mesh description available from stream stream in
the Scotch mesh format (see section 5.2).
To ease the handling of source mesh files by programs written in C as well as
in Fortran, The base value of the mesh to read can be set to 0 or 1, by setting
the baseval parameter to the proper value. A value of -1 indicates that the
mesh base should be the same as the one provided in the mesh description
that is read from stream.
Fortran users must use the PXFFILENO or FNUM functions to obtain the number
of the Unix file descriptor fildes associated with the logical unit of the mesh
file.
Return values
SCOTCH meshLoad returns 0 if the mesh structure has been successfully allo-
cated and filled with the data read, and 1 else.
96