.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH catgets 3 "17 maja 2025 r." "Linux man\-pages 6.15" 
.SH NAZWA
catgets \- pobiera komunikat z katalogu komunikatów
.SH BIBLIOTEKA
Standardowa biblioteka C (\fIlibc\fP,\ \fI\-lc\fP)
.SH SKŁADNIA
.nf
\fB#include <nl_types.h>\fP
.P
\fBchar *catgets(nl_catd \fP\fIkatalog\fP\fB, int \fP\fInumer_zbioru\fP\fB, int \fP\fInumer_komunikatu\fP\fB,\fP
\fB              const char *\fP\fIkomunikat\fP\fB);\fP
.fi
.SH OPIS
Funkcja \fBcatgets\fP() odczytuje komunikat o numerze \fInumer_komunikatu\fP z
zestawu \fInumer_zestawu\fP z katalogu komunikatów identyfikowanego przez
deskryptor \fIkatalog\fP, zwrócony wcześniej przez \fBcatopen\fP(3). Czwarty
argument \fIkomunikat\fP wskazuje na domyślny komunikat, który zostanie
zwrócony przez \fBcatgets\fP(), jeśli katalog komunikatów nie jest obecnie
dostępny. Tekst komunikatu znajduje się w wewnętrznym buforze, więc jeśli
aplikacja chce go przechować lub zmodyfikować, powinna go najpierw
skopiować. Zwracamy łańcuch zawsze kończy się bajtem null
(\[Bq]\[rs]0\[rq]).
.SH "WARTOŚĆ ZWRACANA"
Jeśli funkcja \fBcatgets\fP() zakończy się pomyślnie, zwraca wskaźnik do
obszaru bufora zawierającego łańcuch z komunikatem zakończonym bajtem
null. Jeśli funkcja \fBcatgets\fP() zawiedzie, zwraca wartość \fIkomunikat\fP.
.SH ATRYBUTY
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interfejs	Atrybut	Wartość
T{
.na
.nh
\fBcatgets\fP()
T}	Bezpieczeństwo wątkowe	MT\-bezpieczne
.TE
.SH STANDARDY
POSIX.1\-2008.
.SH HISTORIA
POSIX.1\-2001.
.P
Funkcja \fBcatgets\fP() jest dostępna tylko w libc.so.4.4.4c i wyższych.
.P
Dokument X/Open Portability Guide ze stycznia 1987 określa bardziej
wyrafinowany sposób zwracania wartości w razie wystąpienia błędu:
\fIkomunikat\fP jest zwracany, jeśli katalog wyznaczony przez \fIkatalog\fP jest
niedostępny. Natomiast gdy katalog jest dostępny, ale nie zawiera wskazanego
komunikatu, zwracany jest pusty łańcuch.  Zasada zwracania dwóch różnych
wartości w przypadkach błędów została jednak porzucona w SUSv2 na rzecz
zwracania zawsze wartości \fIkomunikat\fP.
.SH "ZOBACZ TAKŻE"
\fBcatopen\fP(3), \fBsetlocale\fP(3)
.PP
.SH TŁUMACZENIE
Tłumaczenie niniejszej strony podręcznika:
Adam Byrtek <alpha@irc.pl>,
Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>,
Robert Luberda <robert@debian.org>
i
Michał Kułach <michal.kulach@gmail.com>
.
.PP
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach
licencji można uzyskać zapoznając się z
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License w wersji 3
.UE
lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
.PP
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy
dyskusyjnej
.MT manpages-pl-list@lists.sourceforge.net
.ME .