rewind

(PHP 4, PHP 5)

rewind — 倒回文件指针的位置

说明

bool rewind ( resource $handle )

将 handle 的文件位置指针设为文件流的开头。

成功时返回 TRUE，或者在失败时返回 FALSE.

文件指针必须合法，并且指向由 fopen() 成功打开的文件。

Note:
如果将文件以附加（"a" 或者 "a+"）模式打开，写入文件的任何数据总是会被附加在后面，不管文件指针的位置。

参见 fseek() 和 ftell()。

参数

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

返回值

成功时返回 TRUE，或者在失败时返回 FALSE.

范例

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);
?>

以上例程的输出类似于：

Foolly long sentence.

参见

fread() - 读取文件（可安全用于二进制文件）
fseek() - 在文件指针中定位
ftell() - 返回文件指针读/写的位置
fwrite() - 写入文件（可安全用于二进制文件）

add a note User Contributed Notes rewind

MagicalTux at kinoko dot fr 26-Nov-2007 10:53


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.

evan at ozhiker dot no_spam dot com 05-Aug-2004 08:56


As with fseek(), the rewind() function may not be used on file pointers returned by fopen() if they use the "http://" or "ftp://" formats.

add a note