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(7) for descriptions of the following attributes:


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

SEE ALSO

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

August 14, 2002 REWIND(3C)