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) と EINVALに設定 errno。
エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
解説
各ルーチンは、現在位置からファイルから一つの文字を読み取り、次の文字を指すように関連ファイル ポインター (を定義する場合は、インクリメントします。 ファイルは streamに関連付けられます。
これらの関数は呼び出し元スレッドをロックするため、スレッド セーフです。 ロックしないバージョンについては、「_getc_nolock、_getwc_nolock」を参照してください。
ルーチン固有の解説は、次のとおりです。
ルーチン |
解説 |
|---|---|
getc |
fgetcと同様ですが、関数とマクロとして実装されています。 |
getwc |
getc のワイド文字バージョン。 stream がテキスト モードまたはバイナリ モードで開くかによってマルチバイト文字またはワイド文字を読み取ります。 |
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE & _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_gettc |
getc |
getc |
getwc |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
getc |
<stdio.h> |
getwc |
<stdio.h> または <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// 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.