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 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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.