عبارة الإرجاع - كتاب المهارات الرقمية - الصف 8 - الفصل 1 - المملكة العربية السعودية

📚 عبارة الإرجاع (Return Statement)

المفاهيم الأساسية

عبارة الإرجاع (Return statement): تُستخدم لإنهاء تنفيذ استدعاء الدالة وإرجاع قيمة التعبير. يؤدي ظهورها في أي نقطة من محتوى الدالة إلى إنهاء تنفيذ أوامر الدالة وإعادة المقطع البرمجي إلى النقطة التي تلي أمر استدعائه مباشرة.

خريطة المفاهيم

```markmap

الدوال في بايثون

تعريف الدالة

الكلمة الأساسية `def`

اسم الدالة

النقطتان `:`

محتوى الدالة (Function Body)

#### المعاملات (Parameters)

##### تُحدد داخل الأقواس `()`

##### مفصولة بفاصلة

##### متغيرات محلية (Local Variables)

#### عبارة الإرجاع `return`

##### الغرض

###### إنهاء تنفيذ الدالة

###### إرجاع قيمة التعبير

##### قواعد الاستخدام

###### لا يمكن استخدامها خارج الدالة

###### في حال عدم إضافتها، لا تعيد الدالة أي شيء

##### الفرق بين `return` و `print`

###### `return`: يعطي قيمة أو ردًا لمستخدم الدالة

###### `print`: ينتج نصًا مطبوعًا على الشاشة

استدعاء الدالة

استخدام اسم الدالة متبوعًا بأقواس `()`

تمرير الوسائط (Arguments)

#### قيم تُمرر للمعاملات عند الاستدعاء

الميزة الرئيسية

إمكانية الاستدعاء مرارًا وتكرارًا

دوال جاهزة في بايثون

`print()`

`len()`

`range()`

`input()`

```

نقاط مهمة

• تُنهي عبارة `return` تنفيذ الدالة فورًا وتُرجع قيمة.
• لا يمكن استخدام `return` خارج نطاق تعريف الدالة.
• الفرق الأساسي بين `return` و `print` هو أن `return` يُرجع قيمة للبرنامج نفسه، بينما `print` يُظهر ناتجًا للمستخدم.
• إذا لم تحتوِ الدالة على `return`، فإنها لا تُرجع أي قيمة (تُرجع `None`).
• يمكن استخدام `return` داخل الشروط (مثل `if-elif-else`) لإرجاع قيم مختلفة بناءً على حالة معينة.

عبارة الإرجاع

في بايثون، تُستخدم عبارة الإرجاع (Return statement) لإنهاء تنفيذ استدعاء الدالة وإرجاع قيمة التعبير. يؤدي ظهور عبارة الإرجاع في أي نقطة من محتوى الدالة إلى إنهاء تنفيذ أوامر الدالة وإعادة المقطع البرمجي إلى النقطة التي تلي أمر استدعائه مباشرة.

def squareRoot(a): return a*a # المقطع البرمجي الرئيس # finalNumber = squareRoot(5) print(finalNumber)

لا يمكن استخدام عبارة الإرجاع خارج الدالة.

تعطي عبارة الإرجاع return قيمة ما أو ردًا على مستخدم الدالة، بينما ينتج عن أمر الطباعة print نصًا مطبوعًا.

25

في المثال أدناه، تُرجع دالة الحد الأقصى (maximum) أكبر القيم التي تم إدخالها، وللقيام بذلك تُستخدم جملة else if الشرطية للعثور على القيمة الأعلى ثم إرجاع تلك القيمة.

def maximum(x, y): if x > y: return x elif x == y: return "الأرقام متساوية." else: return y print(maximum(2, 3))

في حال عدم إضافة عبارة إرجاع إلى دالتك، فإن الدالة لا تعيد أي شيء.

3

وزارة التعليم Ministry of Education 2025 - 1447 165

عبارة الإرجاع في بايثون، تُستخدم عبارة الإرجاع (Return statement) لإنهاء تنفيذ استدعاء الدالة وإرجاع قيمة التعبير. يؤدي ظهور عبارة الإرجاع في أي نقطة من محتوى الدالة إلى إنهاء تنفيذ أوامر الدالة وإعادة المقطع البرمجي إلى النقطة التي تلي أمر استدعائه مباشرة. --- SECTION: مثال 1: دالة squareRoot --- def squareRoot(a): return a*a # المقطع البرمجي الرئيس # finalNumber = squareRoot(5) print(finalNumber) لا يمكن استخدام عبارة الإرجاع خارج الدالة. تعطي عبارة الإرجاع return قيمة ما أو ردًا على مستخدم الدالة، بينما ينتج عن أمر الطباعة print نصًا مطبوعًا. 25 في المثال أدناه، تُرجع دالة الحد الأقصى (maximum) أكبر القيم التي تم إدخالها، وللقيام بذلك تُستخدم جملة else if الشرطية للعثور على القيمة الأعلى ثم إرجاع تلك القيمة. --- SECTION: مثال 2: دالة maximum --- def maximum(x, y): if x > y: return x elif x == y: return "الأرقام متساوية." else: return y print(maximum(2, 3)) في حال عدم إضافة عبارة إرجاع إلى دالتك، فإن الدالة لا تعيد أي شيء. 3 وزارة التعليم Ministry of Education 2025 - 1447 165 --- VISUAL CONTEXT --- **FIGURE**: def squareRoot(a): Description: Python code snippet defining a function `squareRoot` that returns the square of its input `a`. It also shows the main program block calling this function with `squareRoot(5)` and printing the result. Context: Illustrates the use of the `return` statement in Python to return a value from a function and the execution flow. **HIGHLIGHT_BOX**: Untitled Description: A pink highlight box containing a tip about the usage of return statements. Key Values: لا يمكن استخدام عبارة الإرجاع خارج الدالة. Context: Provides a critical rule regarding the scope of the return statement in programming. **HIGHLIGHT_BOX**: Untitled Description: A blue highlight box explaining the difference between a return statement and a print statement. Key Values: تعطي عبارة الإرجاع return قيمة ما أو ردًا على مستخدم الدالة، بينما ينتج عن أمر الطباعة print نصًا مطبوعًا. Context: Clarifies the distinct purposes of returning a value from a function versus printing output to the console. **FIGURE**: Untitled Description: A light blue box containing the numerical output '25', which is the result of `squareRoot(5)` (5*5=25). An arrow points from the `print(finalNumber)` line in the code to this output box. Key Values: 25 Context: Shows the result returned by the `squareRoot` function and printed to the console. **FIGURE**: def maximum(x, y): Description: Python code snippet defining a function `maximum` that takes two arguments `x` and `y`. It uses `if-elif-else` conditional statements to compare `x` and `y` and returns the larger value, or the string 'الأرقام متساوية.' if they are equal. The main program block calls this function with `maximum(2, 3)` and prints the result. Context: Illustrates the use of `return` statements within conditional logic (`if-elif-else`) to return different values based on input conditions. **HIGHLIGHT_BOX**: Untitled Description: A pink highlight box containing a tip about the behavior of a function without a return statement. Key Values: في حال عدم إضافة عبارة إرجاع إلى دالتك، فإن الدالة لا تعيد أي شيء. Context: Explains the default behavior of a function in Python if no explicit return statement is present. **FIGURE**: Untitled Description: A light blue box containing the numerical output '3', which is the result of `maximum(2, 3)`. An arrow points from the `print(maximum(2, 3))` line in the code to this output box. Key Values: 3 Context: Shows the result returned by the `maximum` function when comparing 2 and 3, which is 3.