BEZEICHNUNG¶

catgets - Meldungen aus einem Meldungskatalog erhalten

ÜBERSICHT¶

#include <nl_types.h>

char *catgets(nl_catd Katalog, int Gruppennummer, int Meldungsnummer,
              const char *Meldung);

BESCHREIBUNG¶

catgets() liest die Meldung Meldungsnummer in der Gruppe Gruppennummer aus dem durch Katalog bezeichneten Meldungskatalog, wobei Katalog ein durch einen vorangegangenen Aufruf von catopen(3) zurückgelieferter Katalogdeskriptor ist. Das vierte Argument, Meldung, zeigt auf eine Vorgabe-Meldungszeichenkette, die von catgets() zurückgeliefert wird, falls der bezeichnete Meldungskatalog derzeit nicht verfügbar ist. Der Meldungstext wird in einem internen Pufferbereich aufgenommen und sollte von der Anwendung kopiert werden, falls er gespeichert oder verändert werden soll. Die zurückgelieferte Zeichenkette wird immer mit einem Null-Byte (»\0«) abgeschlossen.

RÜCKGABEWERT¶

Im Erfolgsfall liefert catgets() einen Zeiger auf einen internen Pufferbereich zurück, der die mit NULL abgeschlossene Meldung enthält. Im Fehlerfall liefert catgets() die Meldung zurück.

ATTRIBUTE¶

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

KONFORM ZU¶

POSIX.1-2001, POSIX.1-2008.

ANMERKUNGEN¶

Die Funktion catgets() ist nur in libc.so.4.4.4c und neuer verfügbar. Der »Jan 1987 X/Open Portability Guide« spezifiziert eine raffiniertere Fehler-Rückmeldung: Meldung wird zurückgeliefert, falls der durch Katalog festgelegte Meldungskatalog nicht verfügbar ist, während eine leere Zeichenkette zurückgeliefert wird, falls der Meldungskatalog verfügbar ist, aber nicht die festgelegte Meldung enthält. Diese zwei möglichen Fehler-Rückmeldungen scheinen in SUSv2 verworfen zu sein, stattdessen soll immer Meldung zurückgeliefert werden.

SIEHE AUCH¶

catopen(3), setlocale(3)

KOLOPHON¶

Diese Seite ist Teil der Veröffentlichung 5.13 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG¶

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.