PHP 8.4.0 RC4 available for testing

rewind

(PHP 4, PHP 5, PHP 7, PHP 8)

rewindRewind the position of a file pointer

Description

rewind(resource $stream): bool

Sets the file position indicator for stream to the beginning of the file stream.

Note:

If you have opened the file in append ("a" or "a+") mode, any data you write to the file will always be appended, regardless of the file pointer position.

Parameters

stream

The file pointer must be valid, and must point to a file successfully opened by fopen().

Return Values

Returns true on success or false on failure.

Examples

Example #1 rewind() overwriting example

<?php
$handle
= fopen('output.txt', 'r+');

fwrite($handle, 'Really long sentence.');
rewind($handle);
fwrite($handle, 'Foo');
rewind($handle);

echo
fread($handle, filesize('output.txt'));

fclose($handle);
?>

The above example will output something similar to:

Foolly long sentence.

See Also

  • fread() - Binary-safe file read
  • fseek() - Seeks on a file pointer
  • ftell() - Returns the current position of the file read/write pointer
  • fwrite() - Binary-safe file write

add a note

User Contributed Notes 1 note

up
13
MagicalTux at kinoko dot fr
16 years ago
Note that rewind($fd) is exactly the same as fseek($fd, 0, SEEK_SET)

rewind() just moves the location inside the file to the beginning, nothing more. Check if your stream is "seekable" before planning to use fseek/rewind.
To Top