الاعلان عن دالة يبدأ ب function وينتهي ب

الاعلان عن دالة يبدأ ب function وينتهي ب

مقدمة

الدالة هي كتلة من التعليمات البرمجية مصممة لإنجاز مهمة محددة. تبدأ الدالة في لغة بايثون بكلمة function وينتهي بعلامة النقطتين (:). يمكن أن تقبل الدالة معلمات ويمكن أيضًا أن ترجع قيمًا.

1. بناء جملة الدالة

بناء جملة الدالة في لغة بايثون هو كما يلي:

“`

def function_name(parameters):

“””

Docstring

“””

Function body

return value

“`

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

المعلمات: المعلمات هي المدخلات التي تتلقاها الدالة لتنفيذ مهمتها. يمكن أن يكون للمعلمات نوع بيانات محدد أو يمكن أن تكون اختيارية.

مستند الوثيقة docstring: يشرح مستند الوثيقة docstring غرض الدالة وكيفية استخدامها.

جسم الدالة: جسم الدالة هو الجزء الذي يحتوي على تعليمات الدالة. يجب أن يبدأ جسم الدالة بعلامة النقطتين (:).

القيمة المُرجعة: القيمة المُرجعة هي القيمة التي ترجعها الدالة عند تنفيذها. يمكن أن تكون قيمة العائد من أي نوع بيانات، أو يمكن ألا ترجع أي قيمة على الإطلاق.

2. أنواع الدوال

هناك نوعان رئيسيان من الدوال في لغة بايثون:

الدوال المضمنة: الدوال المضمنة هي الدوال التي تأتي مع لغة بايثون. وهذه الدوال متوفرة دائمًا ويمكن استخدامها دون الحاجة إلى استيراد أي وحدات.

الدوال المُستخدمة: الدوال المُستخدمة هي الدوال التي يكتبها المبرمجون. يمكن إنشاء الدوال المُستخدمة في أي مكان في البرنامج ويمكن استيرادها واستخدامها في وحدات أخرى.

3. تعريف الدوال

يتم تعريف الدوال في لغة بايثون باستخدام كلمة function يليها اسم الدالة والمعلمات بين قوسين. يجب أن يبدأ جسم الدالة بعلامة النقطتين (:).

“`

def function_name(parameters):

Function body

return value

“`

على سبيل المثال، الدالة التالية تحسب مساحة المثلث:

“`

def calculate_area_of_triangle(base, height):

“””

Calculates the area of a triangle.

Args:

base: The base of the triangle in centimeters.

height: The height of the triangle in centimeters.

Returns:

The area of the triangle in square centimeters.

“””

area = 0.5 base height

return area

“`

4. استدعاء الدوال

يتم استدعاء الدوال في لغة بايثون باستخدام اسم الدالة متبوعًا بالقيم الفعلية للمعلمات بين قوسين.

“`

function_name(argument1, argument2, …)

“`

على سبيل المثال، لاستدعاء الدالة `calculate_area_of_triangle()` التي تم تعريفها أعلاه، سنكتب:

“`

area = calculate_area_of_triangle(10, 5)

“`

ستقوم هذه التعليمات بحساب مساحة مثلث بقاعدة 10 سم وارتفاع 5 سم وتخزين النتيجة في المتغير `area`.

5. القيم المُرجعة

يمكن للدوال ترجيع قيم من أي نوع بيانات. إذا لم ترجع الدالة أي قيمة، فإنها سترجع قيمة `None`.

“`

def calculate_area_of_triangle(base, height):

“””

Calculates the area of a triangle.

Args:

base: The base of the triangle in centimeters.

height: The height of the triangle in centimeters.

Returns:

The area of the triangle in square centimeters.

“””

area = 0.5 base height

return area

“`

يمكن استخدام القيمة المُرجعة للدالة في تعليمات أخرى في البرنامج. على سبيل المثال، يمكننا استخدام قيمة العائد للدالة `calculate_area_of_triangle()` لحساب محيط المثلث:

“`

area = calculate_area_of_triangle(10, 5)

perimeter = 3 area

“`

6. المعلمات الافتراضية

يمكن للدوال أن يكون لها معلمات افتراضية. المعلمات الافتراضية هي المعلمات التي يتم تعيين قيمة لها إذا لم يتم تمرير قيمة لها عند استدعاء الدالة.

“`

def calculate_area_of_triangle(base, height, units=”cm”):

“””

Calculates the area of a triangle.

Args:

base: The base of the triangle.

height: The height of the triangle.

units: The units of measurement for the base and height.

Returns:

The area of the triangle in square units.

“””

area = 0.5 base height

return area

“`

في الدالة أعلاه، المعلمة `units` هي معلمة افتراضية يتم تعيينها إلى “cm” افتراضيًا. إذا لم يتم تمرير قيمة لمعلمة `units` عند استدعاء الدالة، فسيتم استخدام القيمة الافتراضية “cm”.

7. الدوال المتداخلة

يمكن للدوال أن تكون متداخلة، وهذا يعني أنه يمكن تعريف دالة داخل دالة أخرى.

“`

def outer_function():

def inner_function():

print(“Hello from the inner function!”)

inner_function()

outer_function()

“`

ستقوم هذه التعليمات بطباعة “Hello from the inner function!” إلى وحدة التحكم.

الخاتمة

الدوال هي أداة أساسية في أي لغة برمجة. يمكن استخدام الدوال لتقسيم البرنامج إلى وحدات أصغر وأكثر قابلية للإدارة، ويمكن أيضًا استخدامها لإعادة استخدام الكود.

أضف تعليق