次の方法で共有


rewind

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

void rewind( 
   FILE *stream  
);

パラメーター

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

解説

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

(void) fseek( stream###,0L, SEEK_SET ###) ;

ただし、fseekとは異なり、巻き戻し はストリーム、または EOF のエラー インジケーターをクリアします。 また、fseekとは異なり、巻き戻し はポインターが正常に移動されていないかどうかを示す値を返します。

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

ストリームが NULL のポインターの場合、無効なパラメーター ハンドラーが パラメーターの検証"に説明されているように、呼び出されます。 実行の継続 EINVALへの関数の戻り値と errno このが設定されます。

エラー コードの詳細については、「_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 を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

ストリーム入出力