_fgetc_nolock、_fgetwc_nolock

更新 : 2007 年 11 月

スレッドをロックすることなく、ストリームから文字を読み込みます。

int _fgetc_nolock( 
   FILE *stream 
);
wint_t _fgetwc_nolock( 
   FILE *stream 
);

パラメータ

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

戻り値

fgetc、fgetwc を参照してください。

解説

_fgetc_nolock と _fgetwc_nolock は、他のスレッドからの干渉から保護されない点を除いて、それぞれ fgetc および fgetwc と同じです。スレッドをロックアウトするオーバーヘッドがないため、この方が処理が早くなります。これらの関数は、シングルスレッド アプリケーションや、呼び出し元のスコープで既にスレッドの隔離が処理されている場合などの、スレッド セーフなコンテキストだけで使用します。

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

必要条件

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

使用例

// crt_fgetc_nolock.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: 
   if( fopen_s( &stream, "crt_fgetc_nolock.txt", "r" ) != 0 )
      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_nolock( stream );
   }

   // Add null to end string 
   buffer[i] = '\0';
   printf( "%s\n", buffer );
   fclose( stream );
}

入力 : crt_fgetc_nolock.txt

Line one.
Line two.

出力

Line one.
Line two.

.NET Framework の相当するアイテム

• System::IO::StreamReader::Read

• System::Console::Read

参照

参照

ストリーム入出力

fputc、fputwc

getc、getwc