Prototyp und Beschreibung der Funktion umfroundg()

(Funktion der freischaltpflichtigen Gruppe "Notationsberechnungen")

umfroundg()
Runden einer geographischen Koordinate in [Grad, Min, Sek]-Notation.

Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!):
extern "C" __declspec(dllimport) unsigned long __stdcall umfroundg(
     double *nGeoCoord,
     short nDecPlaces);

Prototyp der DLL-Funktion in Visual Objects Syntax:
_DLL function umfroundg(;
     nGeoCoord ref real8,;                 // 4 Byte
     nDecPlaces as short);                 // 2 Byte
as logic pascal:geodll32.umfroundg         // 4 Byte


Die Funktion rundet eine in [Grad, Min, Sek]-Notation (gggmmss.s)
angegebene Längen- oder Breitenangabe so, dass die Minuten- und
Sekundenanteile nicht größer / gleich 60 werden.


Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben:
nGeoCoord   Geographische Koordinate (Länge oder Breite) als Referenz. Die
(ref)       ursprüngliche Koordinate wird mit dem Ergebnis der Berechnung
            überschrieben.

nDecPlaces  Anzahl der Dezimalstellen, auf die gerundet werden soll

returnWert  Im Fehlerfall gibt die Funktion FALSE zurück, sonst TRUE.


Freischaltung:
Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe
"Notationsberechnungen". Sie wird zusammen mit den anderen Funktionen
der Gruppe durch die Eingabe der bei der Vertriebsfirma erworbenen
Freischaltparameter per Aufruf der Funktion setunlockcode() zur
uneingeschränkten Nutzung frei geschaltet. Ohne die Freischaltung sind nur
wenige Funktionsaufrufe zu Testzwecken (Sharewareprinzip) möglich.