Finds the next segment handle within the specified MBR.
Syntax
GsFunStat GsFindNextSegmentByMbr(GsId gs, GsSegmentHandle
*pSegment);
Arguments
gs ID returned by GsInitWithProps() for the current instance of GeoStan. Input.
*pSegment Pointer to a segment handle. Returns a valid handle to the next segment object, if there is one. Output.
Return Values
GS_ERROR Error occurred. You can retrieve the error using GsErrorGet.
GS_LASTLINE_NOT_FOUND GeoStan could not find pLocale.
GS_NOT_FOUND GeoStan did not find a match.
GS_SUCCESS GeoStan found a match. If returned, pSegment is a valid segment handle that you can use with GsHandleGet(), GsHandleGetCoords(), or GsGetMbr().
Prerequisites
GsFindFirstSegmentByMBR() and GsClear()
Notes
GeoStan handles all geocodes in the spatial query functions in ten-thousandths of degrees—not millionths like GsDataGet().
Before each find function, 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.
Example
See GsFindFirstSegmentByMbr for a code example.
MBR Representation by Lat/Lon
See GsFindFirstSegmentByMbr for an MBR representation by latitude and longitude.