Programmieren mit C++

Die Klasse language ermöglicht den Zugriff auf Strings in verschiedenen Sprachen. Diese Fähigkeit wird als matting bezeichnet.

Wenn die Bibliothek als DLL verwendet wird, wird automatisch beim Start ein language-Objekt instanziert und initialisiert. Beim statischen Binden hingegen erfolgt die Initialisierung in der Funktion OwlMain() durch Aufruf von

InitLanguage ()

In beiden Fällen wird jedoch ein globales Objekt erzeugt, auf das jederzeit zugegriffen werden kann. Aktuell werden sechs Sprachen unterstützt:

• Deutsch
• Englisch
• Holländisch
• Französisch
• Italienischan
• Portugesisch
• Spanisch

Weitere Sprachen können hinzugefügt werden. Ebenso ist es möglich, die aktuellen Texte anzupassen.

Aufzählung

Unterstützte Sprachen

typedef enum idLanguage {
   idUndefLanguage, idEnglish, idDutch, 
   idFrench, idGerman, idItalian, 
   idPortuguese, idSpanish
}

idLanguage listet Konstanten für alle unterstützten Sprachen auf.

Globale Elemente

Aufzählung idLanguage

Language language

language enthält eine globale Instanz der Klasse Language, die einen globalen Zugriff ermöglicht.

Objektvariable language

Language &GetLanguage ()

GetLanguage() liefert einen Zeiger auf das globale Language-Objekt.

Funktion GetLanguage

void InitLanguage()

Über InitLanguage() erfolgt die Initialisierung mit Standardwerten, die der Datei WIN.INI entnommen werden. Die Einsprungfunktion der DLL-Bibliothek ruft diese Funktion automatisch auf. Wird die Bibliothek hinggen statisch eingebunden, muß ein expliziter Aufruf dieser Funktion sichergestellt werden.

Öffentlicher Konstruktor

Funktion InitLanguage

Language ()

Language() setzt die aktuelle Sprache auf englisch, indem die Members currentLanguage und systemLanguage auf die entsprechenden Werte gesetzt werden.

Öffentliche Members

Konstruktor Language

idLanguage currentLanguage

In currentLanguage wird die Konstante der aktuell gesetzten Sprache gespeichert. Diese kann sich durchaus von der gesetzten Systemsprache in systemLanguage unterscheiden.

Member currentLanguage

string longDayPicture

longDayPicture speichert die Standardvorgabe für den Format String für die lange Darstellung.

Member longDayPicture

string shortDayPicture

In shortDayPicture speichert das Objekt die Standardvorgabe für den Format String der kurzen Darstellung.

Member shortDayPicture

idLanguage systemLanguage

systemLanguage speichert die Konstante der Systemsprache, die aus dem Abschnitt [intl] der Datei WIN.INI ermittelt wurde.

Member sytemLanguage

string DaySuffix (
     int day, 
     idLanguage l = idUndefLanguage) const

Liefert den Suffix, der hinter Tagesangaben des Tags day in der Sprache l bei Stringkonvertierungen verwendet wird. Dieser kann, abhängig von der verwendeten Sprache, für die einzelnen Tage des Monats unterschiedlich sein.

Memberfunktion DaySuffix

void GetSystemLanguageInfo ()

GetSystemLanguageInfo() ermittelt die Sprachinformationen aus der Datei WIN.INI und speichert sie im Objekt.

Memberfunktion GetSystemLanguageInfo

string LoadString (int id, idLanguageg l = idUndefLanguage) const

LoadString() wird verwendet, um den String id für die Sprache l aus den Ressourcen zu laden. Die gültigen IDs sind in language.h aufgelistet.

Memberfunktion LoadString

string LongDate (
    idLanguage l = idUndefLanguage) const

LongDate() lädt die Standardvorgabe für lange Datumsangaben der Sprache l.

Memberfunktion LongDate

string LongDay (
    int w, 
    idLanguage l = idUndefLanguage) const

LongDay() lädt den kompletten Namen des Tags w für die Sprache l. Gültige Tage sind 0–6 für Montag–Sonntag.

Memberfunktion LongDay

int LongDayIndex (
     const char *string, 
     idLanguage l = idUndefLanguage) const
int LongDayIndex (
     const string &string, 
     idLanguage l = idUndefLanguage) const

LongDayIndex() ermittelt den Wochentagsindex aus der Stringdarstellung string in der Sprache l. LongDayIndex() ist somit die gegenläufige Funktion zu LongDay().

Memberfunktion LongDayIndex

string LongMonth (
     int m, 
     idLanguage l = idUndefLanguage) const

LongMonth() lädt die komplette Bezeichnung des Monats m für die Sprache l. Gültige Werte für m sind 1–12 für Januar–Dezember.

Memberfunktion LongMonth

int LongMonthIndex (
     const char *string, 
     idLanguage l = idUndefLanguage) const
int LongMonthIndex (
     const string &string, 
     idLanguage l = idUndefLanguage) const

LongMonthIndex() ermittelt den Monatsindex aus dem in string enthalten Monatsnamen. LongMonthIndex() ist die gegenläufige Funktion zu LongMonth().

Memberfunktion LongMonthIndex

void SetCurrentLanguage (
     idLanguage l = idEnglish)

SetCurrentLanguage() setzt die aktuelle Sprache auf l.

Memberfunktion SetCurrentLanguage

string ShortDate (
     idLanguage l = idUndefLanguage) const

ShortDate() lädt die Standardvorgabe für kurze Datumsangaben der Sprache l.

Memberfunktion ShortDate

string ShortDay (int w, idLanguage l = idUndefLanguage) const

ShortDay() lädt die Namensabkürzung des Tags w für die Sprache l. Gültige Tage sind 0–6 für Montag–Sonntag.

Memberfunktion ShortDay

int ShortDayIndex (
     const char *string, 
     idLanguage l = idUndefLanguage) const
int ShortDayIndex (
     const string &string, 
     idLanguage l = idUndefLanguage) const

ShortDayIndex() ermittelt den Wochentagsindex aus der String-Darstellung string in der Sprache l. ShortDayIndex() ist somit die gegenläufige Funktion zu ShortDay().

Memberfunktion ShortDayIndex

string ShortMonth (int m, idLanguage l = idUndefLanguage) const

ShortMonth() lädt die Monatsabkürzung des Monats m für die Sprache l. Gültige Werte für m sind 1–12 für Januar–Dezember.

Memberfunktion ShortMonth

int LongMonthIndex (
     const char *string, 
     idLanguage l = idUndefLanguage) const
int LongMonthIndex (
     const string &string, 
     idLanguage l = idUndefLanguage) const

ShortMonthIndex() ermittelt den Monatsindex aus dem in string enthalten Monatsnamen. ShortMonthIndex() ist die gegenläufige Funktion zu ShortMonth().

Memberfunktion ShortMonthIndex

string SysLongDate () const

Mit SysLongDate() wird die Standardvorgabe des Systems für die lange Datumsdarstellung geladen.

Memberfunktion SysLongDate

string SysShortDate () const

SysShortDate() ermittelt die Standardvorgabe des Systems für kurze Datumsangaben.

Memberfunktion SysShortDate