rewind — reset the file position indicator in a stream
#include <stdio.h>
void rewind(FILE *stream);
[CX] The functionality described on this reference page is aligned with the ISO C standard. Any conflict between the requirements described here and the ISO C standard is unintentional. This volume of POSIX.1-2024 defers to the ISO C standard.The call:
rewind(stream)shall be equivalent to:
(void) fseek(stream, 0L, SEEK_SET)except that rewind() shall also ensure the error indicator is clear when the function returns.
[CX] Since rewind() does not return a value, an application wishing to detect errors should clear errno, then call rewind(), and if errno is non-zero, assume an error has occurred.
The rewind() function shall not return a value.
[CX] Refer to fseek with the exception of [EINVAL] which does not apply.
None.
None.
None.
None.
2.5 Standard I/O Streams , fseek
XBD <stdio.h>
First released in Issue 1. Derived from Issue 1 of the SVID.
Extensions beyond the ISO C standard are marked.
POSIX.1-2008, Technical Corrigendum 1, XSH/TC1-2008/0513 [14] is applied.
Austin Group Defect 1414 is applied, clarifying that rewind() ensures the error indicator is clear when the function returns.
return to top of page