.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification
.\"     http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk>
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fgetws 3 "5 lutego 2023 r." "Linux man\-pages 6.03" 
.SH NAZWA
fgetws \- odczytuje łańcuch szerokich znaków ze strumienia FILE
.SH BIBLIOTEKA
Standardowa biblioteka C (\fIlibc\fP, \fI\-lc\fP)
.SH SKŁADNIA
.nf
\fB#include <wchar.h>\fP
.PP
\fBwchar_t *fgetws(wchar_t \fP\fIws\fP\fB[restrict .\fP\fIn\fP\fB], int \fP\fIn\fP\fB, FILE *restrict \fP\fIstream\fP\fB);\fP
.fi
.SH OPIS
The \fBfgetws\fP()  function is the wide\-character equivalent of the
\fBfgets\fP(3)  function.  It reads a string of at most \fIn\-1\fP wide characters
into the wide\-character array pointed to by \fIws\fP, and adds a terminating
null wide character (L\[aq]\e0\[aq]).  It stops reading wide characters
after it has encountered and stored a newline wide character.  It also stops
when end of stream is reached.
.PP
Programista musi zapewnić w \fIws\fP miejsce na co najmniej \fIn\fP szerokich
znaków.
.PP
Informacje o nieblokujących odpowiednikach znajdują się w
\fBunlocked_stdio\fP(3).
.SH "WARTOŚĆ ZWRACANA"
Funkcja \fBfgetws\fP() w przypadku pomyślnego zakończenia zwraca \fIws\fP.  W
razie natrafienia na koniec strumienia lub wystąpienia błędu zwraca NULL.
.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{
\fBfgetws\fP()
T}	Bezpieczeństwo wątkowe	MT\-bezpieczne
.TE
.hy
.ad
.sp 1
.SH STANDARDY
POSIX.1\-2001, POSIX.1\-2008, C99.
.SH UWAGI
Zachowanie \fBfgetws\fP() zależy od kategorii \fBLC_CTYPE\fP bieżących ustawień
regionalnych.
.PP
W przypadku nieprzekazania dodatkowych informacji przy wywołaniu \fBfopen\fP(3)
rozsądne jest oczekiwanie, że \fBfgetws\fP() faktycznie odczyta wielobajtowy
łańcuch ze strumienia i przetworzy go na szeroki znak.
.PP
Na funkcji tej nie można polegać, gdyż nie pozwala na prawidłowe traktowanie
szerokich znaków null, które mogą się pojawić na wejściu.
.SH "ZOBACZ TAKŻE"
\fBfgetwc\fP(3), \fBunlocked_stdio\fP(3)
.PP
.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są:
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 .
