الدالة 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)
• NULL
• FALSE
• "()array" (مصفوفة فارغة)

سجل التغييرات

الإصدار	الوصف
5.5.0	صبحت الدالة empty()‎‎ تدعم التعابير البرمجية (expressions) بدل دعمها للمتغيرات فقط.
5.4.0	ستعمال الدالة empty()‎‎ مع فهارس غير نصية للسلاسل النصية سيعيد القيمة true.