Prototype and description of the function umfroundn()

(Function of the unlock requiring group "Notation calculations")

 

umfroundn()
Rounding of a geographic coordinate given in [deg, min].

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" __declspec(dllimport) unsigned long __stdcall umfroundn(
     double *nGeoCoord,
     short nDecPlaces);

Prototype of the DLL function in Visual Objects syntax:
_DLL function umfroundn;
     nGeoCoord ref real8,;                 // 4 Byte
     nDecPlaces as short);                 // 2 Byte
as logic pascal:geodll32.umfroundn         // 4 Byte


The function rounds a longitude or latitude given in [deg, min] notation
(gggmm.s) so that the minute portions is not larger / equal 60.


The parameters are passed and/or returned as follows:
nGeoCoord   Geographic coordinate (longitude or latitude) by reference.
(ref)       The original coordinate is overwritten with the result of the
            calculation.

nDecPlaces  Number of decimal places, on which is to be rounded

returnVal   In case of an error the function returns FALSE, otherwise TRUE.


Unlocking:
This function is a component of the unlock requiring function group
"notation calculations". It is unlocked for unrestricted use together with
the other functions of the group by passing the unlock parameters, acquired
from the software distribution company, trough the function setunlockcode().
Without unlocking only a few function calls for test purposes (shareware
principle) are possible.