共用方式為

rewind

  • 發行項

將檔案指標重新置放到檔案開頭。

語法

void rewind(
   FILE *stream
);

參數

stream
FILE 結構的指標。

備註

函式會將 rewind 與 檔案 stream 開頭相關聯的檔案指標重新置放。 的 rewind 呼叫類似於

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

不過，不同於 fseek， rewind 會清除數據流的錯誤指標和檔尾指標。 此外，不同於 fseek， rewind 不會傳回值，指出指標是否成功移動。

若要清除鍵盤緩衝區，請使用 rewind 數據流 stdin，預設會與鍵盤相關聯。

如果 stream 是NULL指標，則會叫用無效的參數處理程式，如參數驗證中所述。 如果允許繼續執行，此函式會傳回 ，並 errno 設定為 EINVAL。

如需這些錯誤碼及其他錯誤碼的相關資訊，請參閱：errno、_doserrno、_sys_errlist 以及 _sys_nerr。

根據預設，此函式的全域狀態會限定於應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

需求

常式 必要的標頭
rewind <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 );
   }
}

輸出

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

另請參閱

資料流 I/O