الدالة rewinddir() في PHP
< 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(): تغلق مجلَّدًا مفتوحًا.