الفرق بين المراجعتين ل"PHP/dir"
جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.) |
|||
| سطر 2: | سطر 2: | ||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
| − | تعيد الدالة <code>dir()</code> نسخةً (instance) من الصنف <code>Directory</code>. | + | تعيد الدالة <code>dir()</code> نسخةً (instance) من الصنف <code>[[PHP/Directory|Directory]]</code>. |
== الوصف == | == الوصف == | ||
| سطر 18: | سطر 18: | ||
== القيم المعادة == | == القيم المعادة == | ||
| − | تُعاد نسخةٌ من الصنف <code>Directory</code> عند نجاح العمليَّة، أو القيمة <code>NULL</code> إن كان هنالك خطأ في أحد المعاملين المُمرَّرين أو كلاهما، أو القيمة <code>FALSE</code> إن حصل خطأ آخر. | + | تُعاد نسخةٌ من الصنف <code>[[CSS/Directory|Directory]]</code> عند نجاح العمليَّة، أو القيمة <code>NULL</code> إن كان هنالك خطأ في أحد المعاملين المُمرَّرين أو كلاهما، أو القيمة <code>FALSE</code> إن حصل خطأ آخر. |
== أمثلة == | == أمثلة == | ||
المثال 1: استعمال الدالة <code>dir()</code> | المثال 1: استعمال الدالة <code>dir()</code> | ||
| − | انتبه رجاءً إلى الطريقة المستعملة للتأكُّد من القيمة التي يعيدها التابع <code>[[PHP/Directory | + | انتبه رجاءً إلى الطريقة المستعملة للتأكُّد من القيمة التي يعيدها التابع <code>[[PHP/Directory/read|Directory::read()]]</code> في الشيفرة التالية. سنتحقَّق إن كانت تلك القيمة مطابقة للقيمة <code>FALSE</code> (مساوية لها ومن ذات نوعها؛ راجع صفحة [[PHP/comparison operators|عوامل المقارنة]] للمزيد من المعلومات)؛ سيؤدِّي وجود عنصر في المجلَّد يعادل اسمه القيمة <code>FALSE</code> إلى الخروج من حلقة التكرار (مثل وجود مجلّد اسمه <code>"0"</code>).<syntaxhighlight lang="php"> |
<?php | <?php | ||
$d = dir("/etc/php5"); | $d = dir("/etc/php5"); | ||
| سطر 44: | سطر 44: | ||
== ملاحظات == | == ملاحظات == | ||
| − | * يعتمد ترتيب محتويات المجلَّد المعادة باستعمال التابع [[PHP/Directory | + | * يعتمد ترتيب محتويات المجلَّد المعادة باستعمال التابع [[PHP/Directory/read|read]] على النظام المستعمل. |
== مصادر == | == مصادر == | ||
مراجعة 02:40، 28 أبريل 2018
(PHP 4, PHP 5, PHP 7)
تعيد الدالة dir() نسخةً (instance) من الصنف Directory.
الوصف
Directory dir ( string $directory [, resource $context ] )
تملك هذه الدالة آلية شبه كائنيَّة التوجه لقراءة المجلَّد. سيُفتح المجلد directory المعطى.
المعاملات
directory
مسار المجلَّد المراد فتحه.
context
ملاحظة: أُضيف دعم المحتوى منذ إصدار PHP 5.0.0. راجع قسم المجرى (stream) للمزيد من الشرح عن المحتوى (context).
القيم المعادة
تُعاد نسخةٌ من الصنف Directory عند نجاح العمليَّة، أو القيمة NULL إن كان هنالك خطأ في أحد المعاملين المُمرَّرين أو كلاهما، أو القيمة FALSE إن حصل خطأ آخر.
أمثلة
المثال 1: استعمال الدالة dir()
انتبه رجاءً إلى الطريقة المستعملة للتأكُّد من القيمة التي يعيدها التابع Directory::read() في الشيفرة التالية. سنتحقَّق إن كانت تلك القيمة مطابقة للقيمة FALSE (مساوية لها ومن ذات نوعها؛ راجع صفحة عوامل المقارنة للمزيد من المعلومات)؛ سيؤدِّي وجود عنصر في المجلَّد يعادل اسمه القيمة FALSE إلى الخروج من حلقة التكرار (مثل وجود مجلّد اسمه "0").
<?php
$d = dir("/etc/php5");
echo "Handle: " . $d->handle . "\n";
echo "Path: " . $d->path . "\n";
while (false !== ($entry = $d->read())) {
echo $entry."\n";
}
$d->close();
?>
سيُظهر المثال السابق نتيجة شبيهة بالتالي:
Handle: Resource id #2
Path: /etc/php5
.
..
apache
cgi
cli
ملاحظات
- يعتمد ترتيب محتويات المجلَّد المعادة باستعمال التابع read على النظام المستعمل.