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.
       ┌───────────────────────────────────────────────────────────────────┬───────────────────────┬───────────┐
       │ Schnittstelle                                                     │ Attribut              │ Wert      │
       ├───────────────────────────────────────────────────────────────────┼───────────────────────┼───────────┤
       │ catgets()                                                         │ Multithread-Fähigkeit │ MT-Sicher │
       └───────────────────────────────────────────────────────────────────┴───────────────────────┴───────────┘

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: debian-l10n-german@lists.debian.org.

Linux man-pages 6.9.1                             15. Juni 2024                                       catgets(3)