catgets(3) Library Functions Manual catgets(3) BEZEICHNUNG catgets - Meldungen aus einem Meldungskatalog erhalten BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include 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) zuruckgelieferter Katalogdeskriptor ist. Das vierte Argument, Meldung, zeigt auf eine Vorgabe-Meldungszeichenkette, die von catgets() zuruckgeliefert wird, falls der bezeichnete Meldungskatalog derzeit nicht verfugbar ist. Der Meldungstext wird in einem internen Pufferbereich aufgenommen und sollte von der Anwendung kopiert werden, falls er gespeichert oder verandert werden soll. Die zuruckgelieferte Zeichenkette wird immer mit einem Nullbyte (>>\0<<) abgeschlossen. RUCKGABEWERT Im Erfolgsfall liefert catgets() einen Zeiger auf einen internen Pufferbereich zuruck, der die mit einem Nullbyte abgeschlossene Meldung enthalt. Im Fehlerfall liefert catgets() die Meldung zuruck. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +--------------------------------+-------------------------+-----------+ |Schnittstelle | Attribut | Wert | +--------------------------------+-------------------------+-----------+ |catgets() | Multithread-Fahigkeit | MT-Sicher | +--------------------------------+-------------------------+-----------+ STANDARDS POSIX.1-2008. GESCHICHTE POSIX.1-2001. Die Funktion catgets() ist nur in libc.so.4.4.4c und neuer verfugbar. Der >>Jan 1987 X/Open Portability Guide<< spezifiziert eine raffiniertere Fehler-Ruckmeldung: Meldung wird zuruckgeliefert, falls der durch Katalog festgelegte Meldungskatalog nicht verfugbar ist, wahrend eine leere Zeichenkette zuruckgeliefert wird, falls der Meldungskatalog verfugbar ist, aber nicht die festgelegte Meldung enthalt. Diese zwei moglichen Fehler-Ruckmeldungen scheinen in SUSv2 verworfen zu sein, stattdessen soll immer Meldung zuruckgeliefert werden. SIEHE AUCH catopen(3), setlocale(3) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.06 31. Oktober 2023 catgets(3)