Python/itertools/chain

تعيد الدّالة itertools.chain()‎ مُكرّرًا يُعيد عناصر الكائن القابل للتكرار الأول حتى تنتهيَ عناصره، ثمّ ينتقل إلى الكائن القابل للتّكرار التّالي إلى أن تنتهي قيّمه وهكذا… وتُستخدم لمُعالجة عدّة تسلسلات على أنّها تسلسل واحد مُستمرّ.

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

itertools.chain(*iterables)

المعاملات

iterables

الكائنات القابلة للتّكرار المرغوب تحويلها إلى تسلسل واحد مُستمر.

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

مُكرّر يحتوي على جميع عناصر الكائنات القابلة للتّكرار المُعطاة حسب التّرتيب التي مُرّرت فيها.

أمثلة

المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:

>>> c = itertools.chain([1, 2, 3], 'abc')
>>> c
<itertools.chain object at 0x7f0b0833aeb8>
>>> list(c) # تحويل المُكرّر إلى قائمة
[1, 2, 3, 'a', 'b', 'c']

ملاحظات

الدّالة مُكافئة لما يلي:

def chain(*iterables):
    # chain('ABC', 'DEF') --> A B C D E F
    for it in iterables:
        for element in it:
            yield element

انظر أيضًا

• المكرِّرات Iterators في بايثون.
• المولدات Generators في بايثون.

مصادر

• قسم الدالة itertools.chain في توثيق Python الرسمي.