rewind

Přemísťuje ukazatel souboru na začátek souboru.

Syntaxe

void rewind(
   FILE *stream
);

Parametry

stream
Ukazatel na FILE strukturu.

Poznámky

Funkce rewind přeloží ukazatel souboru přidružený stream na začátek souboru. Volání se podobá volání rewind

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

Na rozdíl od fseekfunkce však rewind vymaže indikátory chyb pro datový proud i indikátor konce souboru. Na rozdíl od fseekfunkce nevrací rewind hodnotu, která označuje, jestli byl ukazatel úspěšně přesunut.

Pokud chcete vymazat vyrovnávací paměť klávesnice, použijte rewind se streamem stdin, který je ve výchozím nastavení přidružený k klávesnici.

Pokud je datový proud ukazatelem NULL , vyvolá se neplatná obslužná rutina parametru, jak je popsáno v ověření parametru. Pokud je spuštění povoleno pokračovat, vrátí tato funkce a errno je nastavena na EINVAL.

Informace o těchto a dalších kódech chyb naleznete v tématu , , , a_sys_nerr . _sys_errlist_doserrnoerrno

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Požadavky

Rutina	Požadovaný hlavičkový soubor
rewind	<stdio.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Knihovny

Všechny verze knihoven runtime jazyka C.

Příklad

// 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 );
   }
}

Výstup

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

Viz také

Vstupně-výstupní operace streamu