dir
(PHP 4, PHP 5)
dir — directory class
תיאור
מנגנון pseudo-object oriented לקריאה מתוך ספריה. המשתנה directory נפתח. שני מאפיינים הינם זמינים לאחר שהספריה נפתחה. ניתן להשתמש במאפיין handle עם פומקציות ספריה נוספות כגון readdir(), rewinddir() and closedir(). המאפיין path מקבל את ערך מיקום הספרייה שנפתחה. ישנן שלושה שיטות אפשריות : read, rewind ו close.
שים לב לדרך שבה הערך שמחזירה הפונקציה dir()'s נבדק בדוגמא מתחת. אנו בודקים בפירוש האם הערך המוחזר זהה(שווה ל וגם מאותו type ,ראה Comparison Operators למידע נוסף) FALSE כי אחרת , כל ערך המוחזר מהספרייה השווה ל FALSE יעצור את הלולאה.
Example#1 dir() דוגמא
$d = dir("/etc");
echo "Handle: ".$d->handle."<br>\n";
echo "Path: ".$d->path."<br>\n";
while (false !== ($entry = $d->read())) {
echo $entry."<br>\n";
}
$d->close();
Note: הסדר שבו מוחזרים ערכי הספריה לאחר שימוש בשיטה read הם system-dependent.
Note: זוהי ההגדרה של ה class Directory, שמשמעותו היא שלא ניתן להגדיר classes עם אותו שם. לרשימה מלאה של classes מוגדרים מראש ב PHP, ראה Predefined Classes.