.\" -*- 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 "15 czerwca 2024 r." "Linux man\-pages 6.9.1" .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 \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 , 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 .