Menu
CoddyTech

استثناء StopIteration

الدرس 3 من 13 في دورة المُكرِّرات في Python على Coddy.

يُعد استثناء StopIteration مكوناً أساسياً في بروتوكول المكرر (iterator protocol) في لغة بايثون. فهو يشير إلى نهاية تسلسل التكرار ويلعب دوراً حيوياً في التحكم في سلوك المكرر. دعونا نستكشف هذا الاستثناء وأهميته.

ما هو StopIteration؟

إن StopIteration هو استثناء مدمج في بايثون يتم إطلاقه عندما يتم استنفاد المكرر، مما يعني عدم وجود المزيد من العناصر لإرجاعها.

متى يتم إطلاق StopIteration؟

يتم إطلاق استثناء StopIteration تلقائياً بواسطة بايثون في سيناريوهين رئيسيين:

  1. عند استدعاء دالة next() على مكرر لا يحتوي على المزيد من العناصر.
  2. عندما يتم تنفيذ تابع __next__() لمكرر مخصص لإطلاق StopIteration في نهاية التكرار.

مثال على StopIteration

دعونا نرى كيف يعمل StopIteration مع مكرر بسيط:

my_list = [1, 2, 3]
my_iterator = iter(my_list)

print(next(my_iterator))  # المخرج: 1
print(next(my_iterator))  # المخرج: 2
print(next(my_iterator))  # المخرج: 3
print(next(my_iterator))  # يطلق StopIteration

في هذا المثال، بعد أن قمنا بالتكرار عبر جميع عناصر my_list، فإن الاستدعاء التالي لـ next() يطلق استثناء StopIteration.

الأهمية في سلوك المكرر

يعد استثناء StopIteration أمراً بالغ الأهمية لعدة أسباب:

  1. الإشارة إلى النهاية: يوفر إشارة واضحة بأن التكرار قد وصل إلى نهايته.
  2. إنهاء حلقة For: تعتمد حلقات for في بايثون على StopIteration لمعرفة متى يجب التوقف.
  3. التحكم في المكرر المخصص: عند إنشاء مكررات مخصصة، يتيح لك إطلاق StopIteration تحديد متى يجب أن ينتهي التكرار.

التعامل مع StopIteration

بينما تتعامل حلقات for مع StopIteration تلقائياً، عند استخدام next() مباشرة، قد ترغب في التعامل مع هذا الاستثناء بشكل صريح:

my_iterator = iter([1, 2, 3])

try:
    while True:
        item = next(my_iterator)
        print(item)
except StopIteration:
    print("Iteration finished")

سيقوم هذا الكود بطباعة الأرقام 1 و 2 و 3، متبوعة بـ "Iteration finished" عند التقاط استثناء StopIteration.

يعد فهم استثناء StopIteration أمراً ضرورياً للعمل مع المكررات في بايثون، حيث يوفر الآلية للتحكم في التكرارات وإنهائها بطريقة قياسية.

quiz iconاختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

quiz iconاختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

quiz iconاختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

challenge icon

التحدي

سهل

قم بإنشاء مكرر (iterator) مخصص يقوم بتوليد تسلسل من الأعداد الأولية حتى حد معين. يجب أن يستخدم المكرر استثناء StopIteration للإشارة إلى نهاية التسلسل عندما يصل إلى الحد المطلوب أو يتجاوزه.

يتم تزويدك بما يلي:

  • عدد صحيح limit كمدخل

يجب أن يقوم المكرر الخاص بك بـ:

  • توليد الأعداد الأولية بدءاً من 2
  • رفع استثناء StopIteration عندما يتجاوز العدد الأولي التالي الحد المعطى

قم بتنفيذ المكرر كفئة (class) تحتوي على الطريقتين __iter__() و __next__(). استخدم الطريقة __next__() لتوليد العدد الأولي التالي ومعالجة استثناء StopIteration.

اطبع كل عدد أولي تم توليده في سطر جديد.

سيتم توفير المدخلات كسلسلة نصية تمثل عدداً صحيحاً.

جرّب بنفسك

# قراءة المدخلات
limit = int(input())

class PrimeIterator:
    def __init__(self, limit):
        self.limit = limit
        self.current = 2

    def __iter__(self):
        return self

    def __next__(self):
        # TODO: تنفيذ المنطق لتوليد العدد الأولي التالي
        # إذا تجاوز العدد الأولي التالي الحد، ارفع StopIteration
        # أرجع العدد الأولي التالي إذا كان ضمن الحد
        pass

# إنشاء مثيل من PrimeIterator
prime_iter = PrimeIterator(limit)

# التكرار عبر الأعداد الأولية وطباعة كل واحد منها
try:
    for prime in prime_iter:
        print(prime)
except StopIteration:
    pass  # نهاية التكرار

جميع دروس المُكرِّرات في Python

تدرّب بنفسك: مترجم Python عبر الإنترنت