Finds the next street that meets the search criteria.
Syntax
01 GSID PIC S9(9) BINARY.
01 GSFUNSTAT PIC S9(9) BINARY.
01 STREET-HANDLE PIC S9(9) BINARY.
*
CALL "GSFNST" USING GSID, STREET-HANDLE, GSFUNSTAT.Arguments
GSID ID returned by GSINITWP for the current instance of GeoStan. Input.
GSFUNSTAT Return value for the procedure. Output.
STREET-HANDLE Pointer to a streetrange handle. Returns a valid handle to the next street, 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
GSFFST and GSCLEARNotes
This procedure continues to find objects that match the criteria specified in GSFFST.
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.