عرض مصدر Python/itertools/chain.from iterable

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

== البنية العامة ==
<syntaxhighlight lang="python3">
itertools.chain.from_iterable(iterable)
</syntaxhighlight>

== المعاملات ==
=== <code>iterable</code> ===
الكائن القابل للتّكرار المرغوب تحويل الكائنات التي بداخله إلى تسلسل واحد مُستمر.

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

== أمثلة ==
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
<syntaxhighlight lang="python3">
>>> c = itertools.chain.from_iterable(['abc', 'def'])
>>> list(c)
['a', 'b', 'c', 'd', 'e', 'f']
</syntaxhighlight>

== ملاحظات ==
الدّالة مُكافئة لما يلي:
<syntaxhighlight lang="python3">
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
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/iterators|المكرِّرات Iterators في بايثون]].
* [[Python/generators|المولدات Generators في بايثون]].

== مصادر ==
* [https://docs.python.org/3/library/itertools.html#itertools.chain.from_iterable قسم الدالة itertools.chain.from_iterable في توثيق Python الرسمي].
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Modules]]
[[تصنيف:Python itertools]]