.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 Mitchum DSouza .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Updated, aeb, 980809 .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH catgets 3 "5 lutego 2023 r." "Linux man\-pages 6.03" .SH NAZWA catgets \- pobranie komunikatu z katalogu komunikatów .SH BIBLIOTEKA Standardowa biblioteka C (\fIlibc\fP, \fI\-lc\fP) .SH SKŁADNIA .nf \fB#include \fP .PP \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 \fBcatgets\fP() reads the message \fImessage_number\fP, in set \fIset_number\fP, from the message catalog identified by \fIcatalog\fP, where \fIcatalog\fP is a catalog descriptor returned from an earlier call to \fBcatopen\fP(3). The fourth argument, \fImessage\fP, points to a default message string which will be returned by \fBcatgets\fP() if the identified message catalog is not currently available. The message\-text is contained in an internal buffer area and should be copied by the application if it is to be saved or modified. The return string is always terminated with a null byte (\[aq]\e0\[aq]). .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). .ad l .nh .TS allbox; lbx lb lb l l l. Interfejs Atrybut Wartość T{ \fBcatgets\fP() T} Bezpieczeństwo wątkowe MT\-Safe .TE .hy .ad .sp 1 .SH STANDARDY POSIX.1\-2001, POSIX.1\-2008. .SH UWAGI Funkcja \fBcatgets\fP() jest dostępna jedynie w libc.so.4.4.4c i wyższych. 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 Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Adam Byrtek , Andrzej Krzysztofowicz , Robert Luberda i Michał Kułach . .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 .