c_degdms - Converts angles to packed degrees, minutes, seconds (DDMMMSSS.SS) format

SYNTAX

#include "worgen.h"

FUNCTION c_degdms (deg, dms, code, check)

     double             *deg;
     double             *dms;
     char               *code;
     char               *check;

PARAMETERS

deg (input, double)

The input value of the angle in the format specified by code.

dms (output, double)

The output value of the deg in packed degrees, minutes, seconds (DDDMMMSSS.SS) format.

code (input, character, length(*))

The format that deg is currently in.

          = DEG: Total degrees 
          = MIN: Total minutes 
          = SEC: Total seconds

check (input, character, length(*))

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

The c_degdms call is used to convert the deg from the format specified in code to a packed degrees, minutes, seconds format (DDDMMMSSS.SS) and return the value in dms.

RETURN VALUE

c_degdms() returns

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