الكلمة المفتاحية yield: زر الإيقاف المؤقت السحري في بايثون

# دالة بـ return - تنتهي فوراً
def with_return():
    print("بدأت الدالة")
    return 1
    print("هذا السطر لن يُنفذ أبداً!")  # لن يُطبع

result = with_return()
print(f"النتيجة: {result}")
print(f"النوع: {type(result)}")

print("\n" + "="*40 + "\n")

# دالة بـ yield - تتحول لمولد
def with_yield():
    print("بدأت الدالة")
    yield 1
    print("استيقظت الدالة!")
    yield 2
    print("انتهت الدالة")

gen = with_yield()
print(f"النوع: {type(gen)}")  # 
print(f"القيمة الأولى: {next(gen)}")
print(f"القيمة الثانية: {next(gen)}")

# بـ return - تُنشئ قائمة كاملة في الذاكرة
def squares_with_return(n):
    result = []
    for i in range(n):
        result.append(i ** 2)
    return result  # تُرجع القائمة كاملة

# بـ yield - تُنتج قيمة واحدة في كل مرة
def squares_with_yield(n):
    for i in range(n):
        yield i ** 2  # تُرجع قيمة واحدة وتتوقف

# الاستخدام
list_result = squares_with_return(5)
print(f"return: {list_result}")  # [0, 1, 4, 9, 16]
print(f"النوع: {type(list_result)}")  # 

gen_result = squares_with_yield(5)
print(f"\nyield: {gen_result}")  # 
print(f"النوع: {type(gen_result)}")  # 
print(f"القيم: {list(gen_result)}")  # [0, 1, 4, 9, 16]

def step_by_step():
    print("1. بدأت الدالة عملها...")
    yield "الخطوة الأولى"
    
    print("2. استيقظت الدالة لتكمل...")
    yield "الخطوة الثانية"
    
    print("3. الدالة في مرحلتها الأخيرة...")
    yield "الخطوة الثالثة"
    
    print("4. انتهت الدالة تماماً")

# إنشاء المولد (لم يُنفذ أي كود بعد!)
gen = step_by_step()
print(f"أنشأنا المولد: {gen}\n")

# الآن نبدأ بطلب القيم
print(f"استلمنا: {next(gen)}")
print("-" * 40)
print(f"استلمنا: {next(gen)}")
print("-" * 40)
print(f"استلمنا: {next(gen)}")
print("-" * 40)

# محاولة طلب قيمة رابعة
try:
    print(f"استلمنا: {next(gen)}")
except StopIteration:
    print("❌ لا توجد قيم أخرى - المولد انتهى!")

def fibonacci(limit):
    """مولد أرقام فيبوناتشي"""
    a, b = 0, 1
    count = 0
    while count < limit:
        yield a  # أرجع القيمة الحالية
        a, b = b, a + b  # احسب القيمة التالية
        count += 1

# طباعة أول 10 أرقام من متسلسلة فيبوناتشي
print("أول 10 أرقام فيبوناتشي:")
for num in fibonacci(10):
    print(num, end=" ")

print("\n\nأول 15 رقم:")
fib_gen = fibonacci(15)
print(list(fib_gen))

def prime_numbers(max_num):
    """مولد الأعداد الأولية حتى max_num"""
    def is_prime(n):
        if n < 2:
            return False
        for i in range(2, int(n ** 0.5) + 1):
            if n % i == 0:
                return False
        return True
    
    for num in range(2, max_num + 1):
        if is_prime(num):
            yield num

# استخدام
print("الأعداد الأولية حتى 30:")
for prime in prime_numbers(30):
    print(prime, end=" ")
# النتيجة: 2 3 5 7 11 13 17 19 23 29

def custom_range(start, end, step=1):
    """مولد نطاق مخصص مثل range لكن بمزيد من المرونة"""
    current = start
    if step > 0:
        while current < end:
            yield current
            current += step
    else:
        while current > end:
            yield current
            current += step

# أمثلة
print("من 0 إلى 10 بخطوة 2:")
print(list(custom_range(0, 10, 2)))  # [0, 2, 4, 6, 8]

print("\nمن 10 إلى 0 بخطوة -1:")
print(list(custom_range(10, 0, -1)))  # [10, 9, 8, 7, 6, 5, 4, 3, 2, 1]

import random
import time

def temperature_sensor(duration=10):
    """محاكاة حساس حرارة يرسل قراءات"""
    start_time = time.time()
    while time.time() - start_time < duration:
        # محاكاة قراءة حساس الحرارة
        temp = random.uniform(20.0, 35.0)
        timestamp = time.strftime("%H:%M:%S")
        yield (timestamp, round(temp, 2))
        time.sleep(1)  # انتظر ثانية قبل القراءة التالية

# الاستخدام
print("مراقبة الحرارة لمدة 5 ثواني:")
for timestamp, temp in temperature_sensor(5):
    if temp > 30:
        print(f"⚠️  [{timestamp}] تحذير: حرارة عالية! {temp}°C")
    else:
        print(f"✅ [{timestamp}] الحرارة طبيعية: {temp}°C")

def read_large_file(file_path, chunk_size=1024):
    """قراءة ملف كبير بأجزاء صغيرة"""
    with open(file_path, 'r', encoding='utf-8') as file:
        while True:
            chunk = file.read(chunk_size)
            if not chunk:
                break
            yield chunk

# استخدام
# for chunk in read_large_file("huge_file.txt"):
#     process(chunk)  # معالجة كل جزء على حدة

def read_lines_with_numbers(file_path):
    """قراءة ملف مع ترقيم الأسطر"""
    with open(file_path, 'r', encoding='utf-8') as file:
        line_num = 1
        for line in file:
            yield (line_num, line.strip())
            line_num += 1

# استخدام
# for num, line in read_lines_with_numbers("data.txt"):
#     print(f"{num}: {line}")

def read_numbers():
    """قراءة أرقام من مصدر"""
    numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
    for num in numbers:
        yield num

def filter_even(numbers):
    """تصفية الأرقام الزوجية"""
    for num in numbers:
        if num % 2 == 0:
            yield num

def square(numbers):
    """تربيع الأرقام"""
    for num in numbers:
        yield num ** 2

def add_prefix(numbers):
    """إضافة بادئة"""
    for num in numbers:
        yield f"Result: {num}"

# Pipeline: قراءة → تصفية → تربيع → تنسيق
pipeline = add_prefix(square(filter_even(read_numbers())))

print("نتائج Pipeline:")
for result in pipeline:
    print(result)

# النتيجة:
# Result: 4
# Result: 16
# Result: 36
# Result: 64
# Result: 100

def interactive_gen():
    print("بدأ المولد...")
    
    # yield يمكنها استقبال قيمة
    val = yield "أعطني قيمة"
    print(f"استلمت من الخارج: {val}")
    
    val2 = yield f"شكراً على {val}، أعطني قيمة أخرى"
    print(f"استلمت القيمة الثانية: {val2}")
    
    yield f"النتيجة النهائية: {val + val2}"

# الاستخدام
g = interactive_gen()

# يجب استدعاء next() أولاً لبدء المولد
print(next(g))  # "أعطني قيمة"

# الآن يمكننا إرسال قيمة
print(g.send(100))  # يرسل 100 ويطبع: "شكراً على 100، أعطني قيمة أخرى"

# إرسال قيمة ثانية
print(g.send(50))  # يرسل 50 ويطبع: "النتيجة النهائية: 150"

def infinite_counter():
    count = 0
    while True:
        yield count
        count += 1

counter = infinite_counter()
print(next(counter))  # 0
print(next(counter))  # 1
print(next(counter))  # 2

# إنهاء المولد قسرياً
counter.close()

# محاولة استخدامه بعد الإغلاق
try:
    print(next(counter))
except StopIteration:
    print("المولد مُغلق!")

def error_handler():
    try:
        while True:
            val = yield
            print(f"استلمت: {val}")
    except ValueError as e:
        print(f"حدث خطأ: {e}")
        yield "تم معالجة الخطأ"

gen = error_handler()
next(gen)  # بدء المولد
gen.send(10)  # استلمت: 10
gen.send(20)  # استلمت: 20

# رمي استثناء
result = gen.throw(ValueError, "قيمة غير صحيحة!")
print(result)  # تم معالجة الخطأ