fgetc, fgetwc

  • [アーティクル]

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

構文

int fgetc(
   FILE *stream
);
wint_t fgetwc(
   FILE *stream
);

パラメーター

stream
FILE 構造体へのポインター。

戻り値

fgetc は、読み込まれた文字を int として返すか、エラーまたはファイルの末尾を示す EOF を返します。 fgetwc は、エラーまたはファイルの終わりを示すために読み取られた文字または戻り値に対応するワイド文字を a として wint_t返 WEOF します。 両方の関数に対して、エラーと、ファイルの末尾の条件を識別するため feof または ferror を使用します。 読み取りエラーが発生すると、ストリームのエラー インジケーターが設定されます。 の場合streamはNULL、「fgetwcfgetcパラメーターの検証」の説明に従って無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、これらの関数は 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.

関連項目

ストリーム入出力
fputc, fputwc
getc, getwc