عرض مصدر Python/zip

<noinclude>{{DISPLAYTITLE:الدالة <code>zip()‎</code> في بايثون}}</noinclude>
تعيد الدّالة <code>zip()‎</code> مُكرّرًا يُركّب عناصر كلّ من الكائنات القابلة للتّكرار المُعطاة.

== البنية العامة ==
<syntaxhighlight lang="python3">
zip(*iterables)
</syntaxhighlight>

== المعاملات ==
=== <code>iterables</code> ===
مُعامل اختياريّ يُمثّل الكائنات القابلة للتّكرار المرغوب تركيبها.

== القيمة المعادة ==
مُكرّر يحتوي على صفوف تكون عناصرها ذات نفس الفهرس (index) في كلّ عنصر من عناصر الكائنات القابلة للتّكرار. إذ يحتوي مثلا أول صفّ على جميع العناصر التي تكون أول العناصر في الكائنات القابلة للتّكرار المُعطاة (انظر الأمثلة أدناه).

يتوقّف المُكرّر عندما تنتهي عناصر أصغر كائن قابل للتّكرار.

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

إن لم تُمرّر للدّالة أية مُعاملات، فسيُعاد مُكرّر فارغ.

== أمثلة ==
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، نستعمل الدّالة <code>list()‎</code> لعرض ما بداخل المُكرّر النّاتج:
<syntaxhighlight lang="python3">
>>> list(zip([1, 2, 3], 'abc'))
[(1, 'a'), (2, 'b'), (3, 'c')]
>>> list(zip([1, 2, 3], 'abcdfe')) # تُتجاهل القيم الزّائدة
[(1, 'a'), (2, 'b'), (3, 'c')]
>>> list(zip([1, 2, 3], (1, 2, 3))) # تركيب قائمة وصفّ
[(1, 1), (2, 2), (3, 3)]
>>> list(zip([1, 2, 3], range(1, 4))) # تركيب قائمة وكائن مجال 
[(1, 1), (2, 2), (3, 3)]
</syntaxhighlight>

يُمكن مثلا استخدام الدّالة <code>zip()‎</code> مع الدّالة <code>dict()‎</code> لإنشاء قاموس من كائنين قابلين للتّكرار تكون مفاتيحه من الكائن الأول وقيمها من الكائن الثّاني:

<syntaxhighlight lang="python3">
>>> dict(zip("abc", range(3)))
{'a': 0, 'b': 1, 'c': 2}
</syntaxhighlight>

== ملاحظات ==
الدّالة <code>zip()‎</code> مُكافئةٌ لما يلي:
<syntaxhighlight lang="python3">
def zip(*iterables):
    # zip('ABCD', 'xy') --> Ax By
    sentinel = object()
    iterators = [iter(it) for it in iterables]
    while iterators:
        result = []
        for it in iterators:
            elem = next(it, sentinel)
            if elem is sentinel:
                return
            result.append(elem)
        yield tuple(result)
</syntaxhighlight>

تُقدَّر الكائنات القابلة للتّكرار من اليسار إلى اليمين دائمًا. ما يسمح بتركيب سلاسل بيانات إلى مجموعات مُحدّدة الطّول باستخدام الاستدعاء <code>zip‎(‎*‎[‎iter‎(‎s‎)‎]‎*‎n‎)‎</code>. ما يُعيد نفس المُكرّر عدد n مرّات لكي يحتوي كلّ صفّ على نتيجة استدعاء المكرّر n مرّات. ما يسمح بتقسيم المُدخل إلى أجزاء طولها n. على سبيل المثال، سيحتوي المُكرّر النّاتج من الاستدعاء <code>‎zip‎(‎*‎[iter‎(range‎(10‎‎)‎)‎]‎*‎2)</code> الصّفوف التّالية:
<syntaxhighlight lang="python3">
(0, 1), (2, 3), (4, 5), (6, 7), (8, 9)
</syntaxhighlight>
لا تستخدم الدّالة <code>zip‎()‎</code> إلّا إن كانت المُدخلات ذات طول مُتساوٍ أو إن لم تكن القيم المتبقيّة في الكائن القابل للتّكرار الأطول مُهمّة. إن كانت هذه القيم مُهمّة، فاستعمال الدّالة  [[Python/itertools/zip_longest|itertools.zip_longest]] عوضًا عنها، إذ تُبقي هذه الأخيرة على القيم الزّائدة وتُركّبها مع القيمة <code>None‎</code> كما يلي:
<syntaxhighlight lang="python3">
>>> itertools.zip_longest(range(3), 'abcdef')
<itertools.zip_longest object at 0x7fd60f1e8bd8>

>>> list(itertools.zip_longest(range(3), 'abcdef'))
[(0, 'a'), (1, 'b'), (2, 'c'), (None, 'd'), (None, 'e'), (None, 'f')]
</syntaxhighlight>
يُمكن استعمال الدّالة <code>zip‎()‎</code> مع العامل <code>*</code> لفكّ التّركيب:
<syntaxhighlight lang="python3">
>>> x = [1, 2, 3]
>>> y = [4, 5, 6]
>>> zipped = zip(x, y)
>>> list(zipped)
[(1, 4), (2, 5), (3, 6)]
>>> x2, y2 = zip(*zip(x, y))
>>> x == list(x2) and y == list(y2)
True
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/list|القوائم lists في بايثون]].
* [[Python/iterators|المكرِّرات Iterators في بايثون]].
*  [[Python/itertools/zip_longest|itertools.zip_longest]].
* [[Python/dict|القواميس في بايثون]].

== مصادر ==
* [https://docs.python.org/3/library/functions.html#zip قسم الدالة zip في صفحة Functions في توثيق Python الرسمي].
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Built-in Functions]]