rewind


function
<cstdio> 
void rewind ( FILE * stream );

Set position indicator to the beginning

Sets the position indicator associated with stream to the beginning of the file.
A call to rewind is equivalent to:

fseek ( stream , 0L , SEEK_SET );

except that, unlike fseek, rewind clears the error indicator.
On streams open for update (read+write), a call to rewind allows to switch between reading and writing.

Parameters

stream
Pointer to a FILE object that identifies the stream.


Return Value

none

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
 
/* rewind example */
#include <stdio.h>

int main ()
{
  int n;
  FILE * pFile;
  char buffer [27];

  pFile = fopen ("myfile.txt","w+");
  for ( n='A' ; n<='Z' ; n++)
    fputc ( n, pFile);
  rewind (pFile);
  fread (buffer,1,26,pFile);
  fclose (pFile);
  buffer[26]='\0';
  puts (buffer);
  return 0;
}


A file called myfile.txt is created for reading and writing and filled with the alphabet. The file is then rewinded, read and its content is stored in a buffer, that then is written to the standard output:

ABCDEFGHIJKLMNOPQRSTUVWXYZ

See also

fseek Reposition stream position indicator (function)
fsetpos Set position indicator of stream (function)
fflush Flush stream (function)