SYNTAX

#include "worgen.h"

FUNCTION c_decdeg (angle, coform, type)

     double             *angle;
     char               *coform;
     char               *type;

PARAMETERS

angle (input/output, double)

The angle which will be converted to total degrees and then returned using this same variable.

coform (input, character, length(3))

The type of angle that is input to this routine. Valid values are:

     = SEC: Total seconds
     = MIN: Total minutes
     = DMS: degrees, minutes, seconds

type (input, character, length(3))

The angle limits that the output angle value will be checked against. Valid values are:

     = LAT: Latitude--upper limit is 90.0, lower limit is -90.0
     = LON: Longitude--upper limit is 180.0, lower limit is -180.0
     = CIR: Circle--upper limit is 360.0, lower limit is 0.0

DESCRIPTION

c_decdeg will take an angle that is in coform and will convert it to total degrees. The output value will be checked against the limits set up by type.

RETURN VALUE

c_decdeg() returns

     E_SUCC (0) --> successful completion
     E_FAIL (-1) --> operation failed