rewind

Memposisikan ulang penunjuk file ke awal file.

Sintaks

void rewind(
   FILE *stream
);

Parameter

stream
Penunjuk ke FILE struktur.

Keterangan

Fungsi memposisikan rewind ulang penunjuk file yang terkait dengan stream ke awal file. Panggilan ke rewind mirip dengan

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

Namun, tidak seperti fseek, rewind menghapus indikator kesalahan untuk aliran dan indikator akhir file. Selain itu, tidak seperti fseek, rewind tidak mengembalikan nilai untuk menunjukkan apakah penunjuk berhasil dipindahkan.

Untuk menghapus buffer keyboard, gunakan rewind dengan aliran stdin, yang terkait dengan keyboard secara default.

Jika stream adalah NULL penunjuk, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, fungsi ini akan kembali, dan errno diatur ke EINVAL.

Untuk informasi tentang kode kesalahan ini dan lainnya, lihat errno, , _doserrno_sys_errlist, dan _sys_nerr.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Persyaratan

Rutin	Header yang diperlukan
rewind	<stdio.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka

Semua versi pustaka run-time C.

Contoh

// 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

Lihat juga

Streaming I/O