fgetc、fgetwc
ストリームから文字を読み取ります。
int fgetc(
FILE *stream
);
wint_t fgetwc(
FILE *stream
);
パラメーター
- stream
FILE 構造体へのポインター。
戻り値
fgetc は int として読み取られた文字列を返すかエラーを示すために EOF はEOF が見つかりました。返します。fgetwc はwint_t として読み取られた文字に対応したりエラーを示すために WEOF はEOF が見つかりました。返されるワイド文字を返します。両方の関数に対してエラーと EOF が見つかりました。状態を区別するために feof または ferror を使用します。読み取りエラーが発生するとストリームのエラー インジケーターが設定されます。stream が NULL 場合fgetc と fgetwc は パラメーターの検証 に説明されているように無効なパラメーター ハンドラーを呼び出します。実行の継続が許可された場合、これらの関数は errno を EINVAL に設定し、EOF を返します。
解説
これらの関数はstream に関連付けられているファイルの現在の位置から一つの文字を読み取ります。関数には次の文字を指すように関連ファイル ポインターを (定義されていればそれがインクリメントされます)。ストリームに EOF が見つかりました。の場合ストリームのファイルの終端のインジケーターが設定されます。
fgetc は getc と同等ですが関数だけで関数やマクロではなく実行されます。
fgetwc は のワイド文字バージョンです fgetc; これはマルチバイト文字またはワイド文字として stream がテキスト モードまたはバイナリ モードで開くかどうかによって c を読み取ります。
_nolock のサフィックスのバージョンが同じものですが他のスレッドによって干渉から保護されません。
テキストおよびバイナリ モードのワイド文字バージョンとマルチバイト文字の処理の詳細についてはテキストとバイナリ モードの Unicode ストリーム入出力 を参照してください。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_fgettc |
fgetc |
fgetc |
fgetwc |
必要条件
Function |
必須ヘッダー |
|---|---|
fgetc |
<stdio.h> |
fgetwc |
<stdio.h> または <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_fgetc.c
// This program uses getc to read the first
// 80 input characters (or until the end of input)
// and place them into a string named buffer.
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
FILE *stream;
char buffer[81];
int i, ch;
// Open file to read line from:
fopen_s( &stream, "crt_fgetc.txt", "r" );
if( stream == NULL )
exit( 0 );
// Read in first 80 characters and place them in "buffer":
ch = fgetc( stream );
for( i=0; (i < 80 ) && ( feof( stream ) == 0 ); i++ )
{
buffer[i] = (char)ch;
ch = fgetc( stream );
}
// Add null to end string
buffer[i] = '\0';
printf( "%s\n", buffer );
fclose( stream );
}
型 : crt_fgetc.txt
Line one.
Line two.
.gif "c7sskzc1.collapse_all(ja-jp,VS.110).gif")
出力
Line one.
Line two.