الدالة all()‎ في بايثون

تعيد الدّالة 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

انظر أيضًا

• القيم المنطقيّة في بايثون.

مصادر

• قسم الدالة all في صفحة Functions في توثيق Python الرسمي.