NAME
rewind — reset the
file position indicator in a stream
SYNOPSIS
#include
<stdio.h>
void rewind(FILE *stream);
DESCRIPTION
[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-2017 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 clear the
error indicator.
[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.
RETURN VALUE
The rewind () function shall not return a
value.
ERRORS
[CX] Refer to fseek(3) with the exception of [EINVAL] which does not apply.
EXAMPLES
None.
APPLICATION USAGE
None.
RATIONALE
None.
FUTURE DIRECTIONS
None.
SEE ALSO
XBD <stdio.h>
CHANGE HISTORY
First released in Issue 1. Derived from Issue 1 of the SVID.
Issue 6
Extensions beyond the ISO C standard are marked.
Issue 7
POSIX.1-2008, Technical Corrigendum 1, XSH/TC1-2008/0513 [14] is applied.