c_wdbrel - Read the line segments from the WDBII relative file

SYNTAX

FUNCTION c_wdbrel(fp_rel, total_pts, num_pts, pnts)

    FILE	 *fp_rel;
    long	 *total_pts;
    long	 *num_pts;
    float	 pnts[];

PARAMETERS

fp_rel (FILE *, input)

The file pointer to the WDBII relative file.

total_pts (long *, input)

The total number of points in the line segment. This value may be retrieved from the associated WDBII sequential file.

num_pts (long *, output)

The number of points returned in pnts.

pnts (float[], output)

The latitude/longitude points defining the segments. This array must be dimensioned to be two times the maximum number of points to read. Points are stored as latitude and longitude, so two consecutive array elements define one point.

DESCRIPTION

Check to see if the file to read is at the EOF (end of file). Read the points for the segment from the WDBII relative file. Determine the number of points read. This function may be called until all of the points in the line segment have been returned. A maximum of 50 points will be read at a time. Locating to the proper spot within the WDBII relative file may be accomplished by calling c_wdbseq().

RETURN VALUE

c_wdbrel() returns

    E_SUCC --> Successful completion
    E_EOF  --> End of file was encountered
    E_FAIL --> Operation failed