fgetc
, fgetwc
ストリームから単一の文字を読み取ります。
構文
int fgetc(
FILE *stream
);
wint_t fgetwc(
FILE *stream
);
パラメーター
stream
FILE
構造体へのポインター。
戻り値
fgetc
は、読み込まれた文字を int
として返すか、エラーまたはファイルの末尾を示す EOF
を返します。 fgetwc
は、 wint_t
として、読み取られた文字に対応するワイド文字を返すか、エラーまたはファイルの末尾を示す WEOF
を返します。 両方の関数に対して、エラーと、ファイルの末尾の条件を識別するため feof
または ferror
を使用します。 読み取りエラーが発生すると、ストリームのエラー インジケーターが設定されます。 stream
がNULL
されている場合は、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーをfgetc
して呼び出fgetwc
。 実行の継続が許可された場合、これらの関数は errno
を EINVAL
に設定し、EOF
を返します。
解説
これらの各関数は、stream
に関連付けられているファイルの現在の位置から 1 文字を読み取ります。 関数は、次の文字 (定義されている場合) を指すように、関連ファイルのポインターをインクリメントします。 ストリームがファイルの末尾にある場合、ストリームのファイルの末尾を示すインジケーターが設定されます。
fgetc
は getc
と同じですが、関数とマクロではなく関数としてのみ実装されています。
fgetwc
はfgetc
のワイド文字バージョンです。テキスト モードまたはバイナリ モードでstream
を開くと、c をマルチバイト文字またはワイド文字として読み取ります。
_nolock
サフィックス付きのバージョンは同じものですが、他のスレッドによる干渉から保護されない点が異なります。
テキスト モードとバイナリ モードでのワイド文字とマルチバイト文字の処理の詳細については、「 テキスト モードとバイナリ モードでのUnicode ストリーム I/O」を参照してください。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン | _UNICODE と _MBCS が定義されていない |
_MBCS が定義されている |
_UNICODE が定義されている |
---|---|---|---|
_fgettc |
fgetc |
fgetc |
fgetwc |
要件
機能 | 必須ヘッダー |
---|---|
fgetc |
<stdio.h> |
fgetwc |
<stdio.h> または <wchar.h> |
互換性の詳細については、「 Compatibility」を参照してください。
例
// 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.
出力
Line one.
Line two.