REWIND(3C) Standard C Library Functions REWIND(3C)


NAME


rewind - reset file position indicator in a stream

SYNOPSIS


#include <stdio.h>

void rewind(FILE *stream);


DESCRIPTION


The call:

rewind(stream)


is equivalent to:

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


except that rewind() also clears the error indicator.

RETURN VALUES


The rewind() function returns no value.

ERRORS


Refer to fseek(3C) with the exception of EINVAL which does not apply.

USAGE


Because 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.

ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


fseek(3C), attributes(5), standards(5)


August 14, 2002 REWIND(3C)