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

(PHP 4, PHP 5, PHP 7)

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

الوصف

void rewinddir ([ resource $dir_handle ] )

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

المعاملات

dir_handle

مورد مقبض المجلَّد الذي يشير إلى مجلَّد فُتح بطريقة صحيحة باستعمال الدالة opendir()‎. إن لم يعطَ هذا المعامل (أي لم يحدَّد المجلَّد)، فسيكون آخر مجلَّد فُتح باستعمال الدالة opendir()‎.

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

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

أمثلة

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

<?php
$dir = "/images/";

// فتح المجلد وقراءة محتواه
if (is_dir($dir)){
  if ($dh = opendir($dir)){
    //images طباعة جميع أسماء الملفات الموجودة في المجلد
    while (($file = readdir($dh)) !== false){
      echo "filename:" . $file . "<br>";
    }
    rewinddir();
    // طباعة جميع أسماء الملفات مرة أخرى
    while (($file = readdir($dh)) !== false){
      echo "filename:" . $file . "<br>";
    }
    closedir($dh);
  }
}
?>

سيُظهر المثال السابق نتيجة شبيهة بالتالي:

filename: cat.gif
filename: dog.gif
filename: horse.gif
filename: cat.gif
filename: dog.gif
filename: horse.gif

انظر أيضًا

• الدالة opendir()‎: تفتح مجلَّدًا محدَّدًا.
• الدالة readdir()‎: تقرأ عنصرًا واحدًا من محتويات المجلَّد وتعيده.
• الدالة is_dir()‎: تتحقَّق إن كان المسار المُمرَّر إليها مجلَّدًا.
• الدالة closedir()‎: تغلق مجلَّدًا مفتوحًا.

مصادر

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