عرض مصدر Python/generators

<noinclude>{{DISPLAYTITLE:المولدات Generators في بايثون}}</noinclude>
المولّدات هي أداة بسيطة وقوية لإنشاء المكرِّرات. تأخذ المولِّدات صيغة الدوال العادية ولكنّها تستخدم عبارة <code>yield</code> عند إعادة البيانات. في كلّ مرة تستدعى فيها الدالة <code>next()</code>‎ على المولّدات تعود الأخيرة إلى المكان الذي تركته (تتذكر المولّدات جميع القيم والعبارات التي نفّذت أخيرًا). يوضح المثال التالي كيفية إنشاء المولّدات وآلية عملها:<syntaxhighlight lang="python3">
def reverse(data):
    for index in range(len(data)-1, -1, -1):
        yield data[index]
>>>
>>> for char in reverse('golf'):
...     print(char)
...
f
l
o
g

</syntaxhighlight>يمكن إنجاز كل ما تقوم به المولّدات باستخدام [[Python/iterators|مكرِّرات]] صنفية (class-based iterators) كما هو موضّح في قسم [[Python/iterators|المكرِّرات]]. ولكن ما يجعل المولّدات مختصرة بهذه الشاكلة هو أنّ اللغة تنشئ التابعين <code>‎__iter__()‎</code> و <code>‎__next__()</code>‎ بصورة تلقائية.

من الميزات المهمّة أيضًا أنّ المتغيرّات المحلية (local variables) وحالة التنفيذ (execution state) تُحفظان بصورة تلقائية بين عمليات الاستدعاء المتعاقبة، ممّا يسهل كتابة الدوال ويجعلها أكثر وضوحًا مقارنة بالأسلوب الذي يعتمد على متغيرات النسخ مثل <code>self.index</code> و <code>self.data</code>.

وإلى جانب إنشاء التوابع بصورة تلقائية وحفظ حالة البرنامج، تطلق المولِّدات عند انتهاء عملها وبصورة تلقائية الخطأ <code>StopIteration</code>. كلّ ما سبق يجعل عملية إنشاء [[Python/iterators|المكرِّرات]] بنفس سهولة [[Python/defining-functions|إنشاء الدوال]] الاعتيادية.

== تعابير المولّدات Generator Expressions ==
يمكن إنشاء بعض المولّدات البسيطة باستخدام تعابير وصياغات مختصرة شبيهة بصياغة [[Python/list#List Comprehensions|list comprehensions]] ولكن باستخدام الأقواس الهلالية بدلًا من الأقواس المربعة. صمّمت هذه التعابير للاستفادة منها في الحالات التي يكون فيها المولّد محاطًا بدالّة أخرى. تكون تعابير المولّدات أكثر اختصارًا ولكن استخداماتها محدودة مقارنة بطريقة التعريف الكاملة للمولدات، وتميل هذه التعابير لأن تكون أقل استهلاكًا للذاكرة مقارنة بـ [[Python/list#List Comprehensions|list comprehensions]] المقابلة.

إليك فيما يلي بعض الأمثلة:<syntaxhighlight lang="python3">
>>> sum(i*i for i in range(10))                 # مجموع مربّعات الأرقام
285

>>> xvec = [10, 20, 30]
>>> yvec = [7, 5, 3]
>>> sum(x*y for x,y in zip(xvec, yvec))         # الجداء النقطي
260

>>> from math import pi, sin
>>> sine_table = {x: sin(x*pi/180) for x in range(0, 91)}

>>> unique_words = set(word  for line in page  for word in line.split())

>>> valedictorian = max((student.gpa, student.name) for student in graduates)

>>> data = 'golf'
>>> list(data[i] for i in range(len(data)-1, -1, -1))
['f', 'l', 'o', 'g']


</syntaxhighlight>

== مصادر ==
صفحة [https://docs.python.org/3/tutorial/classes.html#generators Classes] في توثيق بايثون الرسمي.
[[تصنيف:Python]]
[[تصنيف:Python Classes]]