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