rewind
檔案的開頭，重新放置檔案的指標。
void rewind(
FILE *stream
);
參數
- stream
指標檔案結構。
備註
倒轉函式會重新調整位置相關聯的檔案指標stream檔案的開頭。 呼叫倒轉類似於
(void) fseek( stream**,** 0L, SEEK_SET );
不過，不同於fseek， 倒轉清除資料流錯誤指標，以及檔案結尾標記。 此外，不像fseek， 倒轉不會傳回值，表示是否已順利移動指標。
若要清除鍵盤緩衝區，請使用倒轉與資料流stdin，其中已經有預設的鍵盤。
如果資料流NULL指標，不正確的參數處理常式會叫用，如所述參數驗證。 如果執行則允許繼續執行，則這個函式會傳回與errno設定為 [ EINVAL。
有關這些及其他錯誤碼資訊，請參閱 _doserrno、 errno、 _sys_errlist，以及 _sys_nerr。
需求
常式 |
所需的標頭 |
|---|---|
倒帶 |
<stdio.h> |
其他的相容性資訊，請參閱相容性在簡介中。
文件庫
所有版本的 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 );
}
}
Output
The values written are: 1 and -37
The values read are: 1 and -37
.NET Framework 對等用法
不適用。 若要呼叫標準的 c 函式，使用PInvoke。 如需詳細資訊，請參閱平台叫用範例。