الفرق بين المراجعتين لصفحة: «PHP/empty»

مراجعة 12:31، 14 مارس 2018

(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`.

@@ سطر 15: / سطر 15: @@
 وسائط أخرى…
-ملاحظة: سابقاً في PHP 5.5، لم تكن تدعم الدالة<code>empty()‎</code>إلا المتغيرات فقط وتمرير أي شيًء آخر سوف يؤدي إلى خطأ من النوع parse error، وبعبارةًٍ آخرى، لن يعمل التعبير البرمجي الآتي مع الدالة<code>empty()‎</code>:‏<code> empty(trim($name))</code> لذا استخدم التعبير <code>trim($name) == false</code>،
+'''ملاحظة:'''
-لن يولَّد تحذيرٌ إذا لم يكن المتغير معرفًا. وهذا يعني أن الدالة ()empty يمكن أن تكافئ التعبير البرمجي الآتي: <code>!isset($var) || $var == false</code>
+سابقاً في PHP 5.5، لم تكن تدعم الدالة<code>empty()‎</code>إلا المتغيرات فقط وتمرير أي شيًء آخر سوف يؤدي إلى خطأ من النوع parse error، وبعبارةًٍ آخرى، لن يعمل التعبير البرمجي الآتي مع الدالة<code>empty()‎</code>:‏<code> empty(trim($name))</code> لذا استخدم التعبير <code>trim($name) == false</code>،
+لن يولَّد تحذيرٌ إذا لم يكن المتغير معرفًا. وهذا يعني أن الدالة <code>empty()‎</code>يمكن أن تكافئ التعبير البرمجي الآتي:
+<code>!isset($var) || $var == false</code>
 == القيم المعادة ==
 ستُعاد قيمة <code>false</code>إذا كان الوسيط (var) موجودًا ولهُ قيمةٌ أخرى غير NULL ولا تساوي الصفر ، ما عدا ذلك ستُعاد القيمة <code>true</code>
+'''القيم التالية تعد قيمًا فارغةً:'''
+*<code>""</code> (سلسلة نصية فارغة)
+*<code>0</code> (تمثيل العدد الصحيح 0)
+*<code>"0.0"</code>(تمثيل العدد العشري 0)
+*<code>NULL</code>
+*<code>FALSE</code>
+*<code>"()array"</code>(مصفوفة فارغة)
+== سجل التغييرات ==
+{| class="wikitable"
+!الإصدار
+!الوصف
+|-
+|5.5.0
+|صبحت الدالة <code>empty()‎</code>‎ تدعم التعابير البرمجية (expressions) بدل دعمها للمتغيرات فقط.
+|-
+|5.4.0
+|ستعمال الدالة <code>empty()‎</code>‎ مع فهارس غير نصية للسلاسل النصية سيعيد القيمة <code>true</code>.
+|}