Namespaces
Variants
Views
Actions

std::rewind

From cppreference.com
< cpp‎ | io‎ | c
 
 
Input/output library
I/O manipulators
C-style I/O
Buffers
(deprecated in C++98)
Streams
Abstractions
File I/O
String I/O
Array I/O
(deprecated in C++98)
(deprecated in C++98)
(deprecated in C++98)
Synchronized Output
Types
Error category interface
(C++11)
 
 
Defined in header <cstdio>
void rewind( std::FILE* stream );

Moves the file position indicator to the beginning of the given file stream.

The function is equivalent to std::fseek(stream, 0, SEEK_SET);, except that end-of-file and error indicators are cleared.

The function drops any effects from previous calls to ungetc.

Contents

[edit] Parameters

stream - file stream to modify

[edit] Return value

(none)

[edit] Example

#include <cstdio>
 
int main()
{
    std::FILE *f;
    char ch;
    char str[20];
 
    f = std::fopen("file.txt", "w");
    for (ch = '0'; ch <= '9'; ch++) {
        std::fputc(ch, f);
    }
    std::fclose(f);
 
 
    std::FILE* f2 = std::fopen("file.txt", "r");
    unsigned int size = std::fread(str, 1, 10, f2);
    std::puts(str);
    std::printf("\n%u\n",size);
 
    std::rewind(f2);
    unsigned int size2 = std::fread(str, 1, 10, f2);
    std::puts(str);
    std::printf("\n%u",size2);
    std::fclose(f2);
}

[edit] See also

moves the file position indicator to a specific location in a file
(function) [edit]
C documentation for rewind