alutGetMajorVersion
Inhaltsverzeichnis
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.
