FPUTWC(3)

NAZWA
fputwc, putwc - zapisanie szerokiego znaku do strumienia FILE

SKŁADNIA
#include <stdio.h>
#include <wchar.h>

wint_t fputwc(wchar_t wc, FILE *stream);
wint_t putwc(wchar_t wc, FILE *stream);

OPIS
Funkcja fputwc() jest szerokoznakowym odpowiednikiem funkcji fputc(3). Zapisuje szeroki znak wc do stream. Gdy ferror(stream) stanie się prawdziwe, to zwraca WEOF. Jeśli wystąpi błąd konwersji szerokiego znaku, ustawia errno na EILSEQ i również zwraca WEOF. W pozostałych przypadkach zwraca wc.

Funkcja lub makro putwc() zachowuje się identycznie jak fgetwc(). Może być zaimplementowane jako makro, więc może wskutek tego rozwijać swój argument więcej niż raz. Nie ma żadnego powodu, aby tej funkcji/makra używać.

Informacje o nieblokujących odpowiednikach znajdują się w unlocked_stdio(3).

WARTOŚĆ ZWRACANA
Funkcja fputwc() zwraca wc, jeśli nie wystąpił żaden błąd, lub WEOF w przeciwnym wypadku. W przypadku błędu ustawiane jest errno, wskazując na przyczynę błędu.

BŁĘDY
Oprócz zwykłych jest jeszcze

EILSEQ
    Konwersja wc do kodowania stosowanego w strumieniu nie powiodła się.

ZGODNE Z
C99, POSIX.1-2001.

UWAGI
Zachowanie fputwc() zależy od kategorii LC_CTYPE bieżących ustawień regionalnych.

W przypadku nieprzekazania dodatkowych informacji przy wywołaniu fopen(3) rozsądne jest oczekiwanie, że fputwc() faktycznie zapisze wielobajtową sekwencję odpowiadającą szerokiemu znakowi wc.

ZOBACZ TAKŻE
fgetwc(3), fputws(3), unlocked_stdio(3)

O STRONIE
Angielska wersja tej strony pochodzi z wydania 3.71 projektu Linux man-pages. Opis projektu, informacje dotyczące zgłaszania błędów, oraz najnowszą wersję oryginału można znaleźć pod adresem http://www.kernel.org/doc/man-pages/.

TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika man są: Andrzej Krzysztofowicz (PTM) <ankry@mif.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>.

Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na stronie http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją 3.71 oryginału.