C言語の標準ライブラリfgetwcのリファレンスです。
概要 | ストリームからワイド文字を1文字読込む。 |
ヘッダ | #include <stdio.h> |
I/F | wint_t fgetwc(FILE *stream); |
戻り値 | そのストリームのファイル終了表示子がセットされている場合、又はストリームがファイルの終わりに達している場合はWEOF。そうでなければ入力ストリームから読み取った次のワイド文字。読取りエラー発生ならWEOF。表現形式エラー発生ならEILSEQ。 |
詳細 | fgetwc関数は、streamで指定された入力ストリームから、ワイド文字をwchar_t型として読み込み、wint_t型に変換して、返却する。この処理は、入力ストリームのファイル終了表示子がセットされておらず、かつそのストリーム上に次のワイド文字が存在する場合に行われる。文字を読み込んだ後は、ファイル位置表示子を進める。読み取りエラーが発生した場合、fgetwc関数は、そのストリームのエラー表示子をセットし、WEOFを返却する。fgetwc関数は、バイト数不足のケースを含めて、表現形式エラーが発生したならば、errnoにEILSEQを格納し、WEOFを返却する。ファイルの終わりと読み取りエラーの区別は、feof関数とferror関数を使用することにより可能である。 |