الدالة empty() في PHP
(PHP 4, PHP 5, PHP 7)
تُحدِّد الدالةempty()إذا كان المتغير فارغًا.
الوصف
bool empty ( mixed $var )
الدالةempty() تتحقق من أنَّ المتغير يُعدّ فارغًا، ويعدّ المتغير فارغًا إذا كان غير موجودٍ أو يساوي القيمةNULL ،الدالةempty()لا تولد تحذيرًا إذا لم يكن المتغير معرفًا.
المعاملات
var
المتغير الذي نريد اختبار قيمته إن كان فارغةً أم لا.
...
وسائط أخرى…
ملاحظة:
سابقاً في PHP 5.5، لم تكن تدعم الدالةempty()إلا المتغيرات فقط وتمرير أي شيًء آخر سوف يؤدي إلى خطأ من النوع parse error، وبعبارةًٍ آخرى، لن يعمل التعبير البرمجي الآتي مع الدالةempty(): empty(trim($name)) لذا استخدم التعبير trim($name) == false،
لن يولَّد تحذيرٌ إذا لم يكن المتغير معرفًا. وهذا يعني أن الدالة empty()يمكن أن تكافئ التعبير البرمجي الآتي:
!isset($var) || $var == false
القيم المعادة
ستُعاد قيمة falseإذا كان الوسيط (var) موجودًا ولهُ قيمةٌ أخرى غير NULL ولا تساوي الصفر ، ما عدا ذلك ستُعاد القيمة true
القيم التالية تعد قيمًا فارغةً:
""(سلسلة نصية فارغة)0(تمثيل العدد الصحيح 0)"0.0"(تمثيل العدد العشري 0)NULLFALSE"()array"(مصفوفة فارغة)
سجل التغييرات
| الإصدار | الوصف |
|---|---|
| 5.5.0 | صبحت الدالة empty() تدعم التعابير البرمجية (expressions) بدل دعمها للمتغيرات فقط.
|
| 5.4.0 | ستعمال الدالة empty() مع فهارس غير نصية للسلاسل النصية سيعيد القيمة true.
|