getwc | Programming Place Plus C言語編 標準ライブラリのリファレンス

トップページC言語編標準ライブラリのリファレンス(名前順)

トップページC言語編標準ライブラリのリファレンス(ヘッダ別)


getwc関数

概要

入力ストリームから、ワイド文字を1文字受け取る。

ヘッダ

stdio.hwchar.h

形式

wint_t getwc(FILE* stream);

引数

stream

入力ストリーム。

戻り値

成功時は入力されたワイド文字が返される。読み取りエラーや表現形式エラーの発生時や、ファイル終了指示子がセットされていた場合は WEOF が返される。

詳細

文字は wchar_t型として読み取られ、wint_t型にキャストした状態で返される。

ファイルの終わりに達していた場合、ファイル終了指示子がセットされる(あるいはすでにセットされているだろう)。読み取りエラーが発生した場合、エラー指示子がセットされる。表現形式エラーが発生した場合は、errnoEILSEQ が格納される。

戻り値が WEOF になるケースは3つあるので、必要に応じて区別を付けなければならない。ファイルの終わりに達したかどうかは feof関数で、読み取りエラーの発生は ferror関数で判定できる。errno を使うのは、表現形式エラーの発生の場合だけである。

引数にstdinを指定することで、標準入力から受け取ることも可能である。

注意

マクロとして実装されている可能性があるため、使い方に注意すること。

使用例

#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>

int main(void)
{
    // 以下の fopen関数の第2引数は、Visual Studio 2017 の機能を使っている。
    // 「, ccs=***」のような表記によって、開かれたストリームに入出力するデータを、
    // そのエンコーディング形式で変換する。

    FILE* fp_in = fopen("test.txt", "r, ccs=UTF-16LE");
    if (fp_in == NULL) {
        fputs("ファイルオープンに失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }

    FILE* fp_out = fopen("out.txt", "w, ccs=UTF-16LE");
    if (fp_out == NULL) {
        fputs("ファイルオープンに失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }

    wint_t c = getwc(fp_in);
    if (c == WEOF) {
        if (feof(fp_in)) {
            // ファイルの終わり
        }
        else if (ferror(fp_in)) {
            // エラー
        }
        else {
            // その他。あり得ない?
        }
    }

    fwprintf(fp_out, L"%lc\n", c);

    if (fclose(fp_out) == EOF) {
        fputs("ファイルクローズに失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }
    if (fclose(fp_in) == EOF) {
        fputs("ファイルクローズに失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }
}

入力ファイル(test.txt)※UTF-16 (LE)

1行目
2行目
3行目

実行結果(out.txt)

関連

標準入力に特化した getwchar関数がある。
名称からして、文字列版は getws関数のように思えるが、そのような標準ライブラリ関数はない。文字列版が必要ならば、fgetws関数を使う。
この関数と等価な fgetwc関数がある。ただし、fgetwc関数は必ず関数として実装されている。
この関数は、getc関数ワイド文字版である。

解説章


参考リンク


更新履歴

’2019/2/12 VisualStudio 2015 の対応終了。

’2018/4/9 全体的に文章を見直し修正。

’2018/1/22 新規作成。



標準ライブラリのリファレンス(名前順)のトップページへ

標準ライブラリのリファレンス(ヘッダ別)のトップページへ

C言語編のトップページへ

Programming Place Plus のトップページへ



はてなブックマーク に保存 Pocket に保存 Facebook でシェア
X で ポストフォロー LINE で送る noteで書く
rss1.0 取得ボタン RSS 管理者情報 プライバシーポリシー
先頭へ戻る