عرض مصدر Python/itertools/product

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

طريقة العمل مُكافئة [[Python/for|لحلقات for]] المُتداخلة في [[Python/generators|تعبير مُولّد]]. مثلًا، الاستدعاء <code>product(A, B)‎</code> يُعيد ما يُعيده التّعبير <code>‎((x,y)‎ for‎ x‎ in A‎ for y in B‎)‎</code>.

تدور الحلقات المُتداخلة مثل عدّاد مسافة (odometer) من العنصر على أقصى اليمين مُتقدّمةً عند كلّ تكرار. يُنشئ هذا النّسق ترتيبًا مُعجميًّا (lexicographic)، لذا فإن كانت الكائنات القابلة للتّكرار المُعطاة مُرتّبةً، فستُنتج [[Python/tuples|صفوف]] الضّرب المُباشر مُرتّبةً.
== البنية العامة ==
<syntaxhighlight lang="python3">
itertools.product(*iterables, repeat=1)
</syntaxhighlight>

== المعاملات ==
=== <code>iterables</code> ===
الكائنات القابلة للتّكرار المرغوب الحصول على حاصل ضرب مُباشر لها.

=== <code>repeat</code> ===
لحساب حاصل الضّرب المُباشر لكائن قابل للتّكرار مع نفسه، حدّد عدد مرّات التّكرار المرغوبة بتمرير العدد كقيمة للمُعامل <code>repeat</code> الاختياريّ. فمثلًا، الاستدعاء <code>product(A, repeat=4)‎</code> هو نفسه الاستدعاء <code>product(A, A, A, A)‎</code>.

== القيمة المعادة ==
حاصل ضرب مُباشر بين عناصر الكائنات القابلة للتّكرار المُعطاة.

== أمثلة ==
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
<syntaxhighlight lang="python3">
>>> list(itertools.product('ABCD', 'xy'))
[('A', 'x'), ('A', 'y'), ('B', 'x'), ('B', 'y'),
 ('C', 'x'), ('C', 'y'), ('D', 'x'), ('D', 'y')]
>>> list(itertools.product(range(2), repeat=3))
[(0, 0, 0), (0, 0, 1), (0, 1, 0), (0, 1, 1),
 (1, 0, 0), (1, 0, 1), (1, 1, 0), (1, 1, 1)]
</syntaxhighlight>

== ملاحظات ==
الدّالة مُكافئة لما يلي، إلّا أنّ التّطبيق الفعلي لا يبني نتائج وسيطةً في الذّاكرة:
<syntaxhighlight lang="python3">
def product(*args, repeat=1):
    # product('ABCD', 'xy') --> Ax Ay Bx By Cx Cy Dx Dy
    # product(range(2), repeat=3) --> 000 001 010 011 100 101 110 111
    pools = [tuple(pool) for pool in args] * repeat
    result = [[]]
    for pool in pools:
        result = [x+[y] for x in result for y in pool]
    for prod in result:
        yield tuple(prod)

</syntaxhighlight>

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

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