Python/itertools/chain.from iterable

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

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

itertools.chain.from_iterable(iterable)

المعاملات

iterable

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

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

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

أمثلة

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

>>> c = itertools.chain.from_iterable(['abc', 'def'])
>>> list(c)
['a', 'b', 'c', 'd', 'e', 'f']

ملاحظات

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

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

انظر أيضًا

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

مصادر

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