الدالة rewind()‎ في PHP

(PHP 4, PHP 5, PHP 7)

ترجع الدالة rewind()‎ مؤشِّر الملف إلى موقع بداية الملف.

الوصف

bool rewind ( resource $handle )

ترجع هذه الدالة موقع المؤشِّر للملف الذي يشير إليه المورد handle إلى بداية مجرى الملف.

ملاحظة: إن فتحت الملف في وضع إضافة البيانات (الوضع a أو الوضع a+)، فإنَّ أي بيانات تكتبها على الملف ستضاف إلى نهايته دومًا بغض النظر عن موقع المؤشِّر الحالي.

المعاملات

handle

مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎.

القيم المعادة

تُعاد القيمة TRUE عند نجاح العمليَّة. خلا ذلك، تُعاد القيمة FALSE.

أمثلة

المثال 1: استعمال الدالة rewind()‎

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

انظر أيضًا

• الدالة ftell()‎: تعيد الموقع الحالي لمؤشِّر القراءة من أو الكتابة على الملف.
• الدالة fseek()‎: تحرِّك مؤشِّر الملف الحالي إلى موقع محدَّد.
• الدالة fread()‎: تقرأ من الملف بطريقة آمنة ثنائيًّا.
• الدالة fwrite()‎: تكتب على الملف بطريقة آمنة ثنائيًّا.

مصادر

• صفحة الدالة rewind في توثيق PHP الرسمي.