gettxt(1) gettxt(1)
NAME
gettxt - Zeichenketten in einer Datenbasis für Meldungstexte auffinden
(get text)
SYNTAX
gettxt meldungsdatei:meldungsnummer ["standard-text"]
BESCHREIBUNG
gettxt sucht in einer Meldungsdatei die einer Meldungsnummer zugeord-
nete Zeichenkette.
ARGUMENTE
meldungsdatei
Einfacher Name (ohne Pfad-Präfix) der Meldungsdatei, in der
gettxt nach meldungsnummer suchen soll. Der einfache Name kann
bis zu 14 Zeichen lang sein und darf keines der folgenden Zeichen
enthalten: Null-Byte (\0), Schrägstrich /, Doppelpunkt.
meldungsdatei muß mit dem Kommando mkmsgs(1) angelegt worden sein
und muß sich im Verzeichnis /usr/lib/locale/Locale/LCMESSAGES
befinden. Dabei entspricht der einfache Name des Verzeichnisses
/usr/lib/locale/Locale der Landessprache, in der die Zeichenketten
geschrieben sind, die in der darunter liegenden Meldungsdatei ent-
halten sind [siehe setlocale(3C)].
In welchem Verzeichnis /usr/lib/locale/Locale die Meldungsdatei
nach der angegebenen meldungsnummer durchsucht wird, können Sie
mit der Umgebungsvariablen LCMESSAGES (siehe unten) steuern.
meldungsnummer
Nummer der gesuchten Zeichenkette in meldungsdatei. Die in
meldungsdatei enthaltenen Zeichenketten sind in aufsteigender
Reihenfolge von 1 bis n durchnumeriert, wobei n die Anzahl der
Zeichenketten in meldungsdatei ist.
"standard-text"
Wenn gettxt die gesuchte Zeichenkette nicht in der Meldungsdatei
finden kann, deren Pfadname durch die Variable LCMESSAGES fest-
gelegt ist, sucht gettxt in der Datei
/usr/lib/locale/C/LCMESSAGES/meldungsdatei nach der
meldungsnummer zugeordneten Zeichenkette. Wenn entweder
meldungsdatei oder meldungsnummer nicht existiert, gibt gettxt
den angegebenen standard-text aus.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
gettxt(1) gettxt(1)
"standard-text" nicht angegeben oder leer "":
Wenn gettxt die gesuchte Zeichenkette nicht in der Meldungsdatei
finden kann, deren Pfadname durch die Variable LCMESSAGES fest-
gelegt ist, sucht gettxt in der Datei
/usr/lib/locale/C/LCMESSAGES/meldungsdatei nach der
meldungsnummer zugeordneten Zeichenkette. Wenn gettxt auch dort
die gesuchte Zeichenkette nicht findet oder wenn meldungsdatei
nicht existiert wird "Message not found!!" ausgegeben.
INTERNATIONALE UMGEBUNG
Die Umgebungsvariable LCMESSAGES bestimmt die Sprache der Meldungs-
texte. Wenn LCMESSAGES nicht oder als leere Zeichenkette definiert
ist, wird der Wert von LANG als Standardwert herangezogen. Ist auch
LANG nicht oder als leere Zeichenkette definiert, verhält sich das
System so, als wäre es nicht internationalisiert.
LCCTYPE bestimmt die Zeichenklassen und die Zeichenkonvertierung.
Wenn LCMESSAGES oder LCCTYPE nicht oder als leere Zeichenkette defi-
niert ist, wird der Wert von LANG als Standardwert für die jeweils
nicht gesetzte oder leere Variable herangezogen. Ist auch LANG nicht
oder als leere Zeichenkette definiert, verhält sich das System so, als
wäre es nicht internationalisiert.
Hat eine der Variablen für die internationale Umgebung einen ungülti-
gen Wert, verhält sich das System so, als wäre keine Variable gesetzt.
Die Umgebungsvariable LCALL bestimmt die gesamte internationale Umge-
bung. LCALL hat Vorrang vor allen anderen Umgebungsvariablen im
Bereich der Internationalisierung.
BEISPIELE
Es sind folgende Dateien vorhanden:
Inhalt von Inputdatei1:
Hallo !\n\007
Gute\t ... Nacht !\n
Guten Morgen !\n
Inhalt von Inputdatei2:
Salut !\n
Bonne nuit !\n
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
gettxt(1) gettxt(1)
Die Meldungsdateien werden folgendermaßen erzeugt und installiert:
Die Verzeichnisse /usr/lib/locale/german/LCMESSAGES und
/usr/lib/locale/french/LCMESSAGES existieren nicht. Der Systemverwal-
ter legt durch folgenden Aufruf das Verzeichnis /usr/lib/locale/german
an und erzeugt darunter eine Datei namens hallo.
$ mkmsgs -i german Inputdatei1 hallo
Der Aufruf
$ mkmsgs Inputdatei2 hallo
erzeugt eine Datei hallo im aktuellen Verzeichnis. Um diese danach mit
gettxt in der Lokale french benützen zu können, muß der Systemverwal-
ter folgende Aktionen durchführen:
$ mkdir /usr/lib/locale/french.ft
$ mkdir /usr/lib/locale/french/LCMESSAGES
$ cp hallo /usr/lib/locale/french/LCMESSAGES/hallo
Auf diese Dateien wird folgendermaßen zugegriffen: Angenommen,
LCMESSAGES ist leer und LANG hat den Wert german:
$ gettxt hallo:1 "Hello!\n"
Hallo !
Gleichzeitig ertönt das Klingelzeichen.
$ gettxt hallo:2 "Good Night!\n"
Gute ... Nacht !
$ gettxt hallo:3 "Good Morning!\n"
Guten Morgen !
$ LCMESSAGES=french
$ export LCMESSAGES
$ gettxt hallo:1 "Hello!\n"
Salut !
$ gettxt hallo:2 "Good Night!\n"
Bonne nuit !\n
$ gettxt hallo:3 "Good Morning!\n"
Message not found!!
Der Aufruf hallo:3 bewirkt die Ausgabe von Message not found!!, da es
in der Datei /usr/lib/locale/french/LCMESSAGES/hallo nur 2 Meldungen
gibt.
$ LCMESSAGES=invalid
$ gettxt hallo:1 "Hello!\n"
Hello
$ gettxt hallo:2 "Good Night!\n"
Good Night!
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98
gettxt(1) gettxt(1)
Der Aufruf hallo:1 bzw. der Aufruf hallo:2 bewirkt die Ausgabe von
"standard-text", da es keine Datei
/usr/lib/locale/invalid/LCMESSAGES/hallo gibt. Ohne die Angabe von
"standard-text" würde "Message not found" ausgegeben werden [siehe
gettxt(3C)].
DATEIEN
/usr/lib/locale/Locale/LCMESSAGES/*
Meldungsdateien für verschiedene Landessprachen, die von mkmsgs
angelegt wurden.
/usr/lib/locale/C/LCMESSAGES/*
Standard-Meldungsdateien, die von mkmsgs angelegt wurden.
SIEHE AUCH
exstr(1), mkmsgs(1), srchtxt(1), gettxt(3C), setlocale(3C).
Seite 4 Reliant UNIX 5.44 Gedruckt 11/98