الدالة 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

انظر أيضًا

مصادر