.\" -*- coding: UTF-8 -*- .\" Copyright (c) Bruno Haible .\" .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA) .\" This is free documentation; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License as .\" published by the Free Software Foundation; either version 2 of .\" the License, or (at your option) any later version. .\" %%%LICENSE_END .\" .\" 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 .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH FGETWS 3 "6 marca 2019 r." GNU "Podręcznik programisty Linuksa" .SH NAZWA fgetws \- odczytuje łańcuch szerokich znaków ze strumienia FILE .SH SKŁADNIA .nf \fB#include \fP .PP \fBwchar_t *fgetws(wchar_t *\fP\fIws\fP\fB, int \fP\fIn\fP\fB, FILE *\fP\fIstream\fP\fB);\fP .fi .SH OPIS Funkcja \fBfgetws\fP() jest szerokoznakowym odpowiednikiem funkcji \fBfgets\fP(3). Wczytuje łańcuch zawierający co najwyżej \fIn\-1\fP szerokich znaków do tablicy szerokich znaków wskazywanej przez \fIws\fP oraz dodaje znak końca łańcucha (L\(aq\e0\(aq). Kończy czytanie, gdy natrafi na szeroki znak końca linii. Znak ten jest wczytywany do tablicy. Kończy również w razie napotkania końca strumienia. .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). .TS allbox; lb lb lb l l l. Interfejs Atrybut Wartość T{ \fBfgetws\fP() T} Bezpieczeństwo wątkowe MT\-Safe .TE .SH "ZGODNE Z" 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) .SH "O STRONIE" Angielska wersja tej strony pochodzi z wydania 5.10 projektu Linux \fIman\-pages\fP. Opis projektu, informacje dotyczące zgłaszania błędów oraz najnowszą wersję oryginału można znaleźć pod adresem \%https://www.kernel.org/doc/man\-pages/. .SH TŁUMACZENIE Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Andrzej Krzysztofowicz , Robert Luberda i Michał Kułach . 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. Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres .MT manpages-pl-list@lists.sourceforge.net .ME .