rewind

  • [アーティクル]

ファイルの先頭にファイル ポインターを移動します。

void rewind(
   FILE *stream 
);

パラメーター

  • stream
    ファイル 構造体へのポインター。

解説

巻き戻し ファイル内の関数の先頭に stream に関連付けられたファイル ポインターを移動します。 巻き戻し の呼び出しは似ています

(無効) (fseek stream0L SEEK_SET);

ただしfseek とは異なり 巻き戻し はストリームのエラー インジケーターをオフにするとファイルの終端のインジケーター。またとはfseek異なり巻き戻しはポインターが正常に移動されていないかどうかを示す値を返しません。

キーボードのバッファーを既定ではキーボードに関連付けられているストリーム stdin で使用 巻き戻し オフにします。

ストリームが NULL のポインターと無効なパラメーター ハンドラーが パラメーターの検証 に説明されているように開始されます。実行の継続が許可された場合関数はをerrno はこの EINVAL に設定されます。

エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

必要条件

ルーチン

必須ヘッダー

巻き戻し

<stdio.h>

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

ライブラリ

C ランタイム ライブラリのすべてのバージョン。

使用例

// crt_rewind.c
/* This program first opens a file named
 * crt_rewind.out for input and output and writes two
 * integers to the file. Next, it uses rewind to
 * reposition the file pointer to the beginning of
 * the file and reads the data back in.
 */
#include <stdio.h>

int main( void )
{
   FILE *stream;
   int data1, data2;

   data1 = 1;
   data2 = -37;

   fopen_s( &stream, "crt_rewind.out", "w+" );
   if( stream != NULL )
   {
      fprintf( stream, "%d %d", data1, data2 );
      printf( "The values written are: %d and %d\n", data1, data2 );
      rewind( stream );
      fscanf_s( stream, "%d %d", &data1, &data2 );
      printf( "The values read are: %d and %d\n", data1, data2 );
      fclose( stream );
   }
}

出力

The values written are: 1 and -37
The values read are: 1 and -37

同等の .NET Framework 関数

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

ストリーム入出力