الفرق بين المراجعتين لصفحة: «PHP/disk free space»
< PHP
جميل-بيلوني (نقاش | مساهمات) إضافة محتويات الصفحة. |
ط استبدال النص - 'تصنيف:PHP Filesystem تصنيف:PHP Function' ب'تصنيف:PHP Function تصنيف:PHP Filesystem' |
||
| (مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين) | |||
| سطر 7: | سطر 7: | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
float disk_free_space ( string $directory ) | float disk_free_space ( string $directory ) | ||
</syntaxhighlight>تعيد هذه الدالة عدد البايتات المتاحة على نظام الملفات أو أحد أقسام القرص الصلب بعد تمرير السلسلة النصيَّة <code>directory</code> التي تُمثِّل | </syntaxhighlight>تعيد هذه الدالة عدد البايتات المتاحة على نظام الملفات أو أحد أقسام القرص الصلب بعد تمرير السلسلة النصيَّة <code>directory</code> التي تُمثِّل مسارًا للقسم أو حرفًا للقرص. | ||
== المعاملات == | == المعاملات == | ||
=== <code>directory</code> === | === <code>directory</code> === | ||
مسار أو | مسار القسم أو حرف القرص المراد معرفة مساحته المتاحة. | ||
'''ملاحظة''': إن أعُطي اسم ملفٍ عوضًا عن المسار أو | '''ملاحظة''': إن أعُطي اسم ملفٍ عوضًا عن المسار أو حرف القرص، فسيكون سلوك هذه الدالة غير معروف وسيختلف باختلاف نظام التشغيل وإصدار PHP المُستعمل. | ||
== القيم المعادة == | == القيم المعادة == | ||
يُعاد عدد عشري (float) يمثِّل المساحة المتاح بواحدة البايت، أو تُعاد القيمة <code>FALSE</code> عند فشل العمليَّة. | يُعاد [[PHP/float|عدد عشري (float)]] يمثِّل المساحة المتاح بواحدة البايت، أو تُعاد القيمة <code>FALSE</code> عند فشل العمليَّة. | ||
== أمثلة == | == أمثلة == | ||
| سطر 40: | سطر 40: | ||
* [http://php.net/manual/en/function.disk-free-space.php صفحة الدالة disk_free_space في توثيق PHP الرسمي.] | * [http://php.net/manual/en/function.disk-free-space.php صفحة الدالة disk_free_space في توثيق PHP الرسمي.] | ||
[[تصنيف:PHP]] | [[تصنيف:PHP]] | ||
[[تصنيف:PHP Function]] | |||
[[تصنيف:PHP Filesystem]] | [[تصنيف:PHP Filesystem]] | ||
المراجعة الحالية بتاريخ 04:00، 22 أبريل 2018
(PHP 4 >= 4.1.0, PHP 5, PHP 7)
تعيد الدالة disk_free_space() المساحة المتوافرة (المتاحة) على نظام الملفات أو أحد الأقسام (disk partition).
الوصف
float disk_free_space ( string $directory )
تعيد هذه الدالة عدد البايتات المتاحة على نظام الملفات أو أحد أقسام القرص الصلب بعد تمرير السلسلة النصيَّة directory التي تُمثِّل مسارًا للقسم أو حرفًا للقرص.
المعاملات
directory
مسار القسم أو حرف القرص المراد معرفة مساحته المتاحة.
ملاحظة: إن أعُطي اسم ملفٍ عوضًا عن المسار أو حرف القرص، فسيكون سلوك هذه الدالة غير معروف وسيختلف باختلاف نظام التشغيل وإصدار PHP المُستعمل.
القيم المعادة
يُعاد عدد عشري (float) يمثِّل المساحة المتاح بواحدة البايت، أو تُعاد القيمة FALSE عند فشل العمليَّة.
أمثلة
المثال 1: استعمال الدالة disk_free_space()
<?php
// “/” على الحجم المتاح بالبايت على المجلد الجذر $df سيحتوي المتغير
$df = disk_free_space("/");
// أمَّا على ويندوز، فيُستعمل دليل القرص
$df_c = disk_free_space("C:");
$df_d = disk_free_space("D:");
?>
ملاحظات
لا تعمل هذه الدالة مع الملفات البعيدة إذ يجب أن يكون الملف قابلًا للوصول عبر نظام ملفات الخادم.
انظر أيضًا
- الدالة
disk_total_space(): إعادة المساحة الكلِّيَّة لنظام الملفات أو أحد الأقسام.