الدالة all() في بايثون
< Python
تعيد الدّالة all() القيمة True إن كانت جميع عناصر الكائن القابل للتكرار (iterable) المعطى تُساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا.
البنية العامة
all()
المعاملات
iterable
كائن قابل للتكرار، يُمكن أن يكون قائمةً أو مجموعةً أو سلسلةً نصيّة أو أيّ كائنٍ يُمكنك استخدام حلقة التّكرار for عليه للوصول إلى كلّ قيمةٍ من قيمه على حدى.
القيمة المعادة
القيمة True إن كانت جميع عناصر الكائن القابل للتكرار المعطى تُساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. وتُعيد القيمة False في غير ذلك من حالات.
أمثلة
يوضّح المثال التّالي كيفيّة استعمال الدّالة مع الصفوف والقوائم.
>>> tuple_example = (True, True, True)
>>> all(tuple_example) # True
True
>>> tuple_example2 = (True, False, True)
>>> all(tuple_example2) # False
False
>>> tuple_example3 = (True, None, True)
>>> all(tuple_example3) # False
False
>>> numbers_list = [1, 2, 3]
>>> all(numbers_list) # True
True
>>> numbers_list2 = [1, 2, 3, 0]
>>> all(numbers_list2) # False
False
لاحظ في المثال أعلاه أنّ القيمتين 0 وNone تُساويان False.
يُمكن استعمال أي نوع قابل للتّكرار، إذ لا يقتصر الأمر على القوائم والصّفوف فقط.
ملاحظات
الدّالة all() مكافئة للدّالة التّاليّة:
def all(iterable):
for element in iterable:
if not element:
return False
return True