1. مقدمة: الفرق بين “اطبع” و “أعطني”

في الدروس السابقة، كانت دالتنا تقوم بـ print (طباعة النتيجة على الشاشة). لكن في البرامج الحقيقية، نحن لا نريد دائماً رؤية النتيجة على الشاشة، بل نريد من الدالة أن تحسب شيئاً وتعطينا النتيجة لنستخدمها في مكان آخر (مثل حساب فاتورة أو خصم للطالب).

2. الكلمة السحرية return

كلمة return هي التي تخبر الدالة: “انتهي هنا، وخذي هذه القيمة معك إلى الخارج”.

مثال عملي (حساب الخصم في أكاديمية قياوي): 

                                                                          :def calculate_discount(price)
                                            خصم 10% #   discount = price * 0.10 
                               إرجاع السعر النهائي #   return price – discount

                                        # هنا نأخذ النتيجة ونخزنها في متغير جديد
                                          final_price = calculate_discount(100)
                                   (“السعر بعد الخصم هو: {final_price}”f)print    

3. لماذا return أفضل من print؟                                                                              المرونة: يمكنك أخذ النتيجة واستخدامها في معادلة أخرى.

        تعدد المهام: الدالة التي تعيد قيمة يمكن استخدامها في واجهة موقع، أو تطبيق هاتف، أو رسالة نصية، لأنها تعطي “بيانات” وليس مجرد “نص مطبوع”.

       إنهاء الدالة: بمجرد أن يصل بايثون لسطر return فإنه يخرج من الدالة فوراً ولا ينفذ أي سطر بعدها.

4. إرجاع قيم متعددة (مستوى متقدم للمتميزين) بايثون كريم جداً! يمكنك إرجاع أكثر من قيمة في وقت واحد.  

                                                                        :def get_student_stats(scores)
                                                                                  low = min(scores)
                                                                                high = max(scores)
                                                        إرجاع قيمتين معاً # return low, high 

               minimum, maximum = get_student_stats([80, 95, 70, 100])
     (“{maximum}:أعلى درجة،{minimum}:أقل درجة”f)print  

   نصيحة الصديق لطلاب الأكاديمية: “تذكر يا بطل، الدالة بدون return هي مثل موظف قام بالعمل لكنه لم يسلمك التقرير. استخدم return دائماً عندما تريد من الدالة أن تكون جزءاً من عملية أكبر في برنامجك.”   

5. 🔹 مثال بدون return   

6.                                                                                          :def add(a, b)
                                                                                         print(a + b)

                                                                                result = add(3, 4)
                                                                                         print(result)  

7. ❌ النتيجة ستكون:   
8.                                                                                          7                               لأن الدالة لم تُرجِع قيمة.                                                                                None 

9. 🔹 مثال مع return
                                                                                          :def add(a, b)
                                                                                            return a + b

                                                                                      result = add(3, 4)
                                                                                                print(result)
                                                                                 ✔️ النتيجة:

                                                                                                 7  

10. 🔹 استعمال القيمة المسترجعة
                                                                                             :def double(x)
                                                                                           return x * 2

                                                                                value = double(5)
                                                                                 print(value + 10)
                                   ✔️ يمكن استعمال النتيجة في عمليات أخرى.

    🔹 أكثر من return داخل الدالة
                                                                                   :def check_age(age)
                                                                                      :if age >= 18
                                                                                  “مسموح” return 
                                                                                                    :else
                                                                              “غير مسموح”return
    📌 عند تنفيذ return، الدالة تتوقف فورًا.

    🧠 فرق مهم جدًا

    print	return
    يعرض النتيجة	يرجع النتيجة
    للعرض فقط	للاستعمال البرمجي
    لا يُخزّن	يمكن تخزينه

11. اللهم صل وسلم وبارك على خاتم الانبياء والمرسلين .