getchar、getwchar

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

標準入力から文字を読み取ります。

int getchar();
wint_t getwchar();

戻り値

読み出した文字を返します。読み取りエラーが発生した場合またはファイルの終端に達した場合は、getchar が returns EOF、getwchar が WEOF を返します。getchar の場合、エラーとファイルの終端のどちらであるかを確認するには、ferror または feof を使用します。

解説

各ルーチンでは、stdin から 1 文字を読み取り、関連付けられたファイルポインタが次の文字を指すようにポインタを増やします。getchar は、_fgetchar と同じですが、関数およびマクロとして実装されています。

これらの関数は呼び出し元スレッドをロックするため、スレッドセーフになります。ロックされないバージョンについては、「_getchar_nolock、_getwchar_nolock」を参照してください。

汎用テキストルーチンのマップ

TCHAR.H のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_gettchar	getchar	getchar	getwchar

必要条件

ルーチン	必須ヘッダー
getchar	<stdio.h>
getwchar	<stdio.h> または <wchar.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

// crt_getchar.c
// Use getchar to read a line from stdin.

#include <stdio.h>

int main()
{
    char buffer[81];
    int i, ch;

    for (i = 0; (i < 80) && ((ch = getchar()) != EOF)
                         && (ch != '\n'); i++)
    {
        buffer[i] = (char) ch;
    }
       
    // Terminate string with a null character 
    buffer[i] = '\0';
    printf( "Input was: %s\n", buffer);
}

This text

Input was: This text