nl_langinfo(3C) nl_langinfo(3C)
NAME
nllanginfo - Sprachinformationen liefern
SYNTAX
#include <langinfo.h>
char *nllanginfo(nlitem item);
BESCHREIBUNG
nllanginfo() liefert einen Zeiger auf eine nullterminierte Zeichen-
kette mit Informationen über eine bestimmte Sprache oder einen Kultur-
kreis, der durch die Umgebung im Programm definiert wird. Die Konstan-
ten und Werte von item werden in der Datei langinfo.h definiert.
Zum Beispiel:
nllanginfo (ABDAY1);
liefert einen Zeiger auf die Zeichenkette "Dim", wenn die erkannte
Sprache Französisch ist und eine entsprechende Umgebung korrekt
installiert wurde; ist die erkannte Sprache Englisch, so wird ein Zei-
ger auf "Sun" zurückgeliefert.
ERGEBNIS
Wenn setlocale() nicht erfolgreich aufgerufen wurde oder wenn die
"langinfo"-Daten für eine unterstützte Sprache entweder nicht verfüg-
bar sind oder item keine definierte Variable ist, dann liefert
nllanginfo() einen Zeiger auf die entsprechende Zeichenkette in der
C-Umgebung. Wenn item eine ungültige Zeichenkette enthält, liefert
nllanginfo() immer einen Zeiger auf eine leere Zeichenkette.
HINWEISE
Das Feld, auf das der Rückgabewert zeigt, sollte nicht vom Programm
verändert werden. Spätere Aufrufe von nllanginfo() können dieses Feld
überschreiben.
Einige der in langinfo.h definierten Konstanten werden nur im XPG4-
Modus erkannt. Wenn sie im XPG3-Modus als Eingabe verwendet werden,
liefert nllanginfo() einen Zeiger auf eine leere Zeichenkette zurück.
Einen entsprechenden Hinweise finden Sie in der Tabelle bei
langinfo(5).
SIEHE AUCH
gettxt(3C), localeconv(3C), setlocale(3C), strftime(3C), LCTIME(4),
langinfo(5), nltypes(5).
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98