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-Safe │
       └─────────────────────────────────────────────────────────────────────┴───────────────────────┴─────────┘

STANDARDS

       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 zu‐
       rü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.

Linux man-pages 6.03                             5. Februar 2023                                      catgets(3)