عرض مصدر Python/itertools

<noinclude>{{DISPLAYTITLE:الوحدة <code>itertools‎</code> في بايثون}}</noinclude>

تقّدم الوحدة <code>itertools</code> مجموعة من الأدوات المُساعدة على بناء مُكرّرات مُشابهة لتلك المتوفّرة في لغات مثل APL، وHaskell وSML. بُني كلّ منها بطريقة تُناسب لغة بايثون.

الأدوات المُتوفّرة سريعة وتستخدم الذّاكرة بشكل فعّال، وهي مُفيدة سواء بمُفردها أو عبر دمج بعضها ببعض. وعند دمجها مع بعض، تُشكّل "جبرَ مُكرّرات” تُعدّ وسيلة يُمكن استعمالها لإنشاء أدوات أكثر تخصّصًا بشكل فعّال باستخدام بايثون فقط دون الحاجة إلى أيّة لغة برمجيّة أخرى.

تُوفّر لغة SML مثلًا الدّالة <code>tabulate‎(f)‎</code> التي تُنتج السّلسلة <code>‎f(0)‎,‎ ‎f(1)‎,‎ ‎...‎‎</code>. يُمكن الحصول على نفس النّتيجة في بايثون عبر دمج الدّالة <code>[[Python/map|map‎()‎]]</code> والدّالة <code>[[Python/count|count‎()‎]]</code> على شكل <code>‎map‎(‎f‎, ‎count‎(‎)‎)‎</code>.

تعمل هذه الأدوات والدّوال المبنيّة المُكافئة لها جيّدًا مع الدّوال السّريعة الموجودة في الوحدة <code>[[Python/operator|operator]]</code> أيضًا. فمثلًا يُمكن ربط عامل الضّرب (multiplication operator) بين  متّجهتين (vectors) لتشكيل جداء سُلميّ (dot-product) فعّال:
<syntaxhighlight lang="python3">
sum(map(operator.mul, vector1, vector2))
</syntaxhighlight>

== مكررات لامتناهية ==

=== <code>[[Python/itertools/count|itertools.count()‎]]</code> ===
تعيد مُكرّرًا يُعيد قيمًا مُتساويّة الفرق بدءًا من قيمةٍ بدئيّة.

=== <code>[[Python/itertools/cycle|itertools.cycle()‎]]</code> ===
تعيد مُكرّرًا يُعيد عناصر الكائن القابل للتّكرار المُعطى ويحفظ نسخة منه، عندما تنتهي قيم الكائن القابل للتّكرار، يُعيد المُكرّر عناصر النّسخة المحفوظة، ويُكرّر ذلك مرارًا وتكرارًا دون نهاية.

=== <code>[[Python/itertools/repeat|itertools.repeat()‎]]</code> ===
تعيد مُكرّرًا يُعيد كائنًا مرارًا وتكرارًا بشكل لا نهائي أو لعدد مُحدّد من المرّات.

== مكررات تنتهي عند أقصر تسلسل ==

=== <code>[[Python/itertools/accumulate|itertools.accumulate()‎]]</code> ===
تعيد مُكرّرًا يُعيد مجموعات مُتراكمة، أو نتائج مُتراكمةً من دالّة أخرى.

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

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

=== <code>[[Python/itertools/compress|itertools.compress()‎]]</code> ===
=== <code>[[Python/itertools/dropwhile|itertools.dropwhile()‎]]</code> ===
=== <code>[[Python/itertools/filterfalse|itertools.filterfalse()‎]]</code> ===
=== <code>[[Python/itertools/groupby|itertools.groupby()‎]]</code> ===
=== <code>[[Python/itertools/islice|itertools.islice()‎]]</code> ===
=== <code>[[Python/itertools/starmap|itertools.starmap()‎]]</code> ===
=== <code>[[Python/itertools/starmap|itertools.starmap()‎]]</code> ===
=== <code>[[Python/itertools/tee|itertools.tee()‎]]</code> ===
=== <code>[[Python/itertools/zip_longest|itertools.zip_longest()‎]]</code> ===

== مكررات دامجة ==

المُكرّرات الدّامجة تدمجُ بين التّسلسلات لإنشاء تسلسلات أخرى.

=== <code>[[Python/itertools/product|itertools.product()‎]]</code> ===
=== <code>[[Python/itertools/permutations|itertools.permutations()‎]]</code> ===
=== <code>[[Python/itertools/combinations|itertools.combinations()‎]]</code> ===
=== <code>[[Python/itertools/combinations_with_replacement|itertools.combinations_with_replacement()‎]]</code> ===

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