Linux Certif

Toute la documentation sur la certification Linux LPI

fgetwc

NAZWA

fgetwc, getwc - odczytuje szeroki znak ze strumienia FILE

SK£ADNIA

#include <stdio.h>




#include <wchar.h>



wint_t fgetwc(FILE *stream);

wint_t getwc(FILE *stream);

OPIS

Funkcja fgetwc jest szerokoznakowym odpowiednikiem funkcji fgetc. Wczytuje ona szeroki znak ze stream i zwraca go. W razie natrafienia na koniec strumienia lub gdy ferror(stream) stanie siê prawdziwe, zwraca WEOF. Je¶li wyst±pi b³±d konwersji znaku, ustawia ona errno na EILSEQ i równie¿ zwraca WEOF.

Funkcja lub makro getwc zachowuje siê identycznie jak fgetwc. Gdy getwc jest zaimplementowane jako makro, 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 fgetwc zwraca nastêpny szeroki znak pobrany ze strumienia lub WEOF.

B£ÊDY

Oprócz zwyk³ych jest jeszcze

EILSEQ

Dane otrzymane ze strumienia wej¶ciowego nie tworz± prawid³owego znaku.

ZGODNE Z

ISO/ANSI C, UNIX98

UWAGI

Zachowanie fgetwc zale¿y od ustawienia kategorii LC_CTYPE aktualnego locale.

W przypadku nieprzekazania dodatkowych informacji przy wywo³aniu fopen, rozs±dne jest oczekiwanie, ¿e fgetwc faktycznie odczyta wielobajtowy ³añcuch ze strumienia i przetworzy go na szeroki znak.

ZOBACZ TAK¯E

fputwc(3), fgetws(3), ungetwc(3), unlocked_stdio(3)