Finds the next range object that meets the search criteria.
Syntax
01 GSID PIC S9(9) BINARY.
01 GSFUNSTAT PIC S9(9) BINARY.
01 RANGE-HANDLE PIC S9(9) BINARY.
*
CALL "GSFNRANG" USING GSID, RANGE-HANDLE, GSFUNSTAT.Arguments
GSID ID returned by GSINITWP for the current instance of GeoStan. Input.
GSFUNSTAT Return value for the procedure. Output.
RANGE-HANDLE Pointer to a segment/range handle. Returns a valid handle to the next range object, if there is one. Input, Output.
Return Values
GS-SUCCESS Found a match.
GS-NOT-FOUND Did not find a match.
GS-ERROR An error occurred, use GSERRGET to obtain more information.
Prerequisites
GSFFSEG and GSCLEAR
Notes
This procedure continues to find objects that match the criteria specified in GSFFRANG.
If GeoStan finds a matching segment, you can retrieve the data for that segment using GSHGET.
Before each find procedure, call GSCLEAR to reset the internal buffers. If you do not reset the buffers, you may receive incorrect results with information from a previous find.
For more information, see Extracting Data from GSD Files.