次の方法で共有

getc, getwc

  • [アーティクル]

ストリームから単一の文字を読み取ります。

構文

int getc(
   FILE *stream
);
wint_t getwc(
   FILE *stream
);

パラメーター

stream
入力ストリーム。

戻り値

読み取られた文字を返します。 読み取りエラーまたはファイルの終端状態を示すために、getc は EOF を返し、getwc は WEOF を返します。 getc の場合、ferror または feof を使用して、エラーまたはファイルの終端を確認します。 streamがNULLされている場合は、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーをgetcして呼び出getwc。 実行を続行できる場合、これらの関数はEOF (またはgetwcの場合はWEOF) を返し、errnoをEINVALに設定します。

リターン コードの詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。

解説

各ルーチンはファイルの現在の位置から 1 文字読み取り、関連付けられたファイル ポインター (定義されている場合) をインクリメントして次の文字を指します。 ファイルは stream に関連付けられています。

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

ルーチン固有の解説は、次のとおりです。

ルーチンによって返される値 解説
getc fgetc と同じですが、関数およびマクロとして実装されます。
getwc getc のワイド文字バージョン。 stream がテキスト モードまたはバイナリ モードで開かれるかどうかに従って、マルチバイト文字またはワイド文字を読み取ります。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。

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

TCHAR.H のルーチン _UNICODE と _MBCS が定義されていない _MBCS が定義されている _UNICODE が定義されている
_gettc getc getc getwc

要件

ルーチンによって返される値 必須ヘッダー
getc <stdio.h>
getwc <stdio.h> または <wchar.h>

互換性の詳細については、「 Compatibility」を参照してください。

例

// crt_getc.c
// Use getc to read a line from a file.

#include <stdio.h>

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

    // Read a single line from the file "crt_getc.txt".

    fopen_s(&fp, "crt_getc.txt", "r");
    if (!fp)
    {
       printf("Failed to open file crt_getc.txt.\n");
       exit(1);
    }

    for (i = 0; (i < 80) && ((ch = getc(fp)) != EOF)
                         && (ch != '\n'); i++)
    {
        buffer[i] = (char) ch;
    }

    // Terminate string with a null character
    buffer[i] = '\0';
    printf( "Input was: %s\n", buffer);

    fclose(fp);
}

入力: crt_getc.txt

Line one.
Line two.

出力

Input was: Line one.

関連項目

ストリーム入出力
fgetc, fgetwc
_getch, _getwch
putc, putwc
ungetc, ungetwc