.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 Mitchum DSouza <m.dsouza@mrc-applied-psychology.cambridge.ac.uk>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" Updated, aeb, 980809
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH catgets 3 "2. Mai 2024" "Linux man\-pages 6.8" 
.SH BEZEICHNUNG
catgets \- Meldungen aus einem Meldungskatalog erhalten
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP)
.SH ÜBERSICHT
.nf
\fB#include <nl_types.h>\fP
.P
\fBchar *catgets(nl_catd \fP\fIKatalog\fP\fB, int \fP\fIGruppennummer\fP\fB, int \fP\fIMeldungsnummer\fP\fB,\fP
\fB              const char *\fP\fIMeldung\fP\fB);\fP
.fi
.SH BESCHREIBUNG
\fBcatgets\fP() liest die Meldung \fIMeldungsnummer\fP in der Gruppe
\fIGruppennummer\fP aus dem durch \fIKatalog\fP bezeichneten Meldungskatalog,
wobei \fIKatalog\fP ein durch einen vorangegangenen Aufruf von \fBcatopen\fP(3)
zurückgelieferter Katalogdeskriptor ist. Das vierte Argument, \fIMeldung\fP,
zeigt auf eine Vorgabe\-Meldungszeichenkette, die von \fBcatgets\fP()
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 (»\e0«) abgeschlossen.
.SH RÜCKGABEWERT
Im Erfolgsfall liefert \fBcatgets\fP() einen Zeiger auf einen internen
Pufferbereich zurück, der die mit einem Nullbyte abgeschlossene Meldung
enthält. Im Fehlerfall liefert \fBcatgets\fP() die \fIMeldung\fP zurück.
.SH ATTRIBUTE
Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt
verwandten Ausdrücke.
.TS
allbox;
lbx lb lb
l l l.
Schnittstelle	Attribut	Wert
T{
.na
.nh
\fBcatgets\fP()
T}	Multithread\-Fähigkeit	MT\-Sicher
.TE
.SH STANDARDS
POSIX.1\-2008.
.SH GESCHICHTE
POSIX.1\-2001.
.P
Die Funktion \fBcatgets\fP() ist nur in libc.so.4.4.4c und neuer verfügbar.
.P
Der »Jan 1987 X/Open Portability Guide« spezifiziert eine raffiniertere
Fehler\-Rückmeldung: \fIMeldung\fP wird zurückgeliefert, falls der durch
\fIKatalog\fP 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 \fIMeldung\fP zurückgeliefert werden.
.SH "SIEHE AUCH"
\fBcatopen\fP(3), \fBsetlocale\fP(3)
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Helge Kreutzmann <debian@helgefjell.de>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .