c_wdbrank - Sort the desired features into WDBII rankings

SYNTAX

FUNCTION c_wdbrank(ftype, fcount, feature, ranks)

    long ftype;
    long fcount;
    long feature[];
    long ranks[];

PARAMETERS

ftype (long, input)

Type of feature to sort:

     = 1	Coastlines, islands, lakes (CIL)
     = 2	Rivers (RIV)
     = 3	International boundaries (BDY)
     = 4	Internal boundaries (PDY)
     = 5	Railroads (RRR)
     = 6	Roads (RDS)

fcount (long, input)

The number of feature classifications to process (the number of classifications specified in feature).

feature (long[], input)

Feature classifications to process based on the feature type. This array must be dimensioned to have at least fcount elements.

Feature type			Feature classification
--------------------------------------------------------------
Coastlines, islands, lakes	= 1:  CIL on all maps
				= 2:  Major islands, lakes
				= 3:  Intermediate islands, lakes
				= 4:  Minor islands and lakes
				= 6:  Intermediate major lakes
				= 7:  Intermediate minor lakes
				= 8:  Reefs
				= 9:  Major salt pans
				= 10: Minor salt pans
				= 13: Major ice shelves
				= 14: Minor ice shelves
				= 15: Glaciers

Rivers				= 1:  Permanent major rivers
				= 2:  Additional major rivers
				= 3:  Additional rivers
				= 4:  Minor rivers
				= 5:  Double-lined rivers
				= 6:  Major intermediate rivers
				= 7:  Other intermediate rivers
				= 8:  Minor intermediate rivers
				= 10: Major canals
				= 11: Minor canals
				= 12: Irrigation canals

International boundaries	= 1:  Demarcated or delimited
or limits of sovereignty	= 2:  Indefinite or in dispute
				= 3:  Other line of separation
				      or sovereignty on land

Internal boundaries		= 1:  First order admin
				= 2:  Second order admin
				= 3:  Third order admin

Railroads			= 11: Broad gauge
				= 12: Standard gauge
				= 13: Narrow gauge

Roads				= 11:  2 or more lanes
				= 12:  Hard-surface highway
				= 13:  Gravel
				= 14:  Unsurfaced
				= 15:  Track, trail, or caravan
				= 16:  Road ferries
				= 17:  Under construction
				= 19:  Undifferentiated
--------------------------------------------------------------

ranks (long[], output)

Sorted rankings from WDBII. A value of one (1) signifies that the feature classification has been selected. A value of zero (0) signifies that the feature classification has not been selected. The number of elements in ranks must be at minimum the total number of feature classifications for the appropriate feature type. This parameter is useful when calling c_wdbseq().

DESCRIPTION

If the input number of features (fcount) to set is zero, select all of the ranks for processing. Otherwise, if the feature type (ftype) is set to zero, return sorted rankings that will process the entire area file. If neither of the above two input values are zero, sort only the ranks that were specified. Check the bounds of the valid features for the given feature type.

RETURN VALUE

c_wdbrank() returns

    E_SUCC --> Successful completion
    E_FAIL --> Operation failed