alutGetMajorVersion

Aus DGL Wiki
Wechseln zu: Navigation, Suche

alutGetMajorVersion

Name

alutGetMajorVersion - Gibt die Hauptversionsnummer der ALUT zurück.


Delphi-Spezifikation

function alutGetMajorVersion: TALint;


Parameter

Diese Funktion hat keine Parameter.


Beschreibung

Die Funktion alutGetMajorVersionNumber gibt die Hauptversionsnummer der benutzten ALUT zurück, welche mit der Hauptversionsnummer des entsprechenden Spezifikationsdokuments übereinstimmt.


Hinweise

Die ALUT-Versionsnummer besteht aus der Hauptversionsnummer, der Nebenversionsnummer und dem Patchlevel. Die ersten beiden Zahlen stimmen mit der Haupt-/ Nebenversionsnummer der zugehörigen ALUT-Spezifikationsdokumentation überein und auf sie kann sowohl zur Kompilier- als auch zur Laufzeit zugegriffen werden. Das Patchlevel ist im Programm selbst nicht abrufbar, jedoch wird es nur angehoben, wenn kleinere Fehler ausgebessert werden, ohne dabei die API zu ändern.


Änderungen

Folgende Erweiterungen hat die Funktion erfahren:

Ab ALUT-Version 1.0.0

In Version 1.0.0 sind die Präprozessorsymbole ALUT_API_MAJOR_VERSION und ALUT_API_MINOR_VERSION eingeführt worden, deren Werte in zukünftigen Revisionen der ALUT entsprechend angehoben werden.

#define ALUT_API_MAJOR_VERSION 1

#define ALUT_API_MINOR_VERSION 0

Dadurch kann eine Anwendung zur Laufzeit prüfen, ob sie mit den passenden Headern und Bibliotheken kompiliert und gelinkt wurde.

#ifdef ALUT_API_MAJOR_VERSION
if (alutGetMajorVersion() != ALUT_API_MAJOR_VERSION ||
    alutGetMinorVersion() != ALUT_API_MINOR_VERSION)
{
  /* Der ALUT-Header und die ALUT-Bibliothek stammen aus unterschiedlichen Revisionen. */
}
#else
  /* Verlinkung gegen ALUT 0.x.x Header */
#endif


Fehlermeldungen

Die Funktion alutGetMajorVersion kann in jedem ALUT-Zustand aufgerufen werden und wird niemals fehlschlagen.


Siehe auch

alutGetMinorVersion