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

تعيد الدّالة any()‎ القيمة True إن كان أحد عناصر الكائن القابل للتكرار (iterable) المعطى يساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا.

البنية العامة

any()

المعاملات

iterable

كائن قابل للتكرار، يُمكن أن يكون قائمةً أو مجموعةً أو سلسلةً نصيّة أو أيّ كائنٍ يُمكنك استخدام حلقة التّكرار for عليه للوصول إلى كلّ قيمةٍ من قيمه على حدى.

القيمة المعادة

القيمة True إن كان أحد عناصر الكائن القابل للتكرار المعطى يُساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. وتُعيد القيمة False في غير ذلك من حالات.

أمثلة

يوضّح المثال التّالي كيفيّة استعمال الدّالة مع الصفوف والقوائم.

>>> tuple_example = (True, True, True)
>>> any(tuple_example) # True
True
>>> tuple_example2 = (True, False, True)
>>> any(tuple_example2) # True
True
>>> tuple_example3 = (True, None, False)
>>> any(tuple_example3) # True
True
>>> numbers_list = [1, 2, 3]
>>> any(numbers_list) # True
True
>>> numbers_list2 = [None, False, 0]
>>> any(numbers_list2) # False
False

لاحظ في المثال أعلاه أنّ القيمتين 0 وNone تُساويان False.

يُمكن استعمال أي نوع قابل للتّكرار، إذ لا يقتصر الأمر على القوائمو الصّفوف فقط.

ملاحظات

الدّالة any()‎ مكافئة للدّالة التّاليّة:

def any(iterable):
    for element in iterable:
        if element:
            return True
    return False

انظر أيضًا

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

مصادر

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