BEZEICHNUNG

catgets - Meldungen aus einem Meldungskatalog erhalten

BIBLIOTHEK

Standard-C-Bibliothek (libc, -lc)

Ü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 Nullbyte (»\0«) abgeschlossen.

RÜCKGABEWERT

Im Erfolgsfall liefert catgets() einen Zeiger auf einen internen Pufferbereich zurück, der die mit einem Nullbyte 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.

STANDARDS

POSIX.1-2008.

GESCHICHTE

POSIX.1-2001.

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)

Ü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.