استخدام الدوال لتنظيم الكود

1. ما هي الدالة ولماذا نستخدمها؟

ببساطة، الدالة هي مجموعة من الأوامر البرمجية التي تؤدي مهمة محددة، ويمكنك إعطاؤها اسماً. بدلاً من كتابة نفس الكود مراراً وتكراراً، يمكنك كتابته مرة واحدة داخل دالة، ثم "استدعاء" هذه الدالة باسمها كلما احتجت لتنفيذ تلك المهمة.

هذا المبدأ، المعروف بـ "لا تكرر نفسك" (Don't Repeat Yourself - DRY)، هو من أهم مبادئ البرمجة النظيفة والفعالة.

2. تعريف دالة بسيطة واستدعاؤها

الآن بعد أن فهمنا "لماذا"، لنر "كيف". لتعريف دالة في بايثون، نستخدم الكلمة المفتاحية def، متبوعة باسم الدالة الذي نختاره، ثم قوسين ()، وأخيراً نقطتين رأسيتين :. الأوامر التي تنتمي للدالة يجب أن تكون مُزاحة (indented) بمسافة بادئة، تماماً كما فعلنا مع الحلقات والجمل الشرطية.

دعنا نرى كيف يتم ذلك عملياً.

للتلخيص، العملية تتم على خطوتين:

1. التعريف (Definition): ننشئ الدالة ونحدد ماذا ستفعل.

   # تعريف الدالة
   def say_hello():
       print("مرحباً بك في عالم الدوال!")
   

2. الاستدعاء (Call): نطلب من البرنامج تنفيذ الكود الموجود داخل الدالة.

   # استدعاء الدالة
   say_hello()
   

   الناتج:

   مرحباً بك في عالم الدوال!
   

إذا لم نستدعِ الدالة say_hello()، فلن يتم طباعة أي شيء على الإطلاق.

3. تمرير المعلومات إلى الدوال (المعاملات والوسائط)

الدوال تصبح أكثر فائدة عندما يمكنها استقبال بيانات والعمل عليها. يمكننا "تمرير" بيانات إلى الدالة عند استدعائها.

• المعامل (Parameter): هو المتغير الذي نضعه بين القوسين عند تعريف الدالة. إنه بمثابة مكان مخصص لاستقبال قيمة.
• الوسيط (Argument): هي القيمة الفعلية التي نرسلها إلى الدالة عند استدعائها.

مثال:

# 'name' هنا هو المعامل (Parameter)
def greet_person(name):
    print(f"أهلاً بك، {name}!")

# 'علي' و 'فاطمة' هنا هما الوسيطان (Arguments)
greet_person("علي")
greet_person("فاطمة")

الناتج:

أهلاً بك، علي!
أهلاً بك، فاطمة!

لاحظ كيف أعدنا استخدام نفس الدالة greet_person لأداء نفس المهمة (الترحيب) ولكن ببيانات مختلفة في كل مرة.

# تعريف الدالة
def show_info(name, age):
    print(f"{name} يبلغ من العمر {age} عاماً.")

# استدعاء الدالة
show_info("سالم", 28)
show_info("هند", 32)

سالم يبلغ من العمر 28 عاماً.
هند يبلغ من العمر 32 عاماً.

4. إعادة قيمة من الدالة (The return Statement)

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

عندما يصل التنفيذ إلى return، تتوقف الدالة فوراً وتعيد القيمة المحددة.

لنشاهد شرحاً عملياً لذلك.

مثال على دالة تقوم بعملية حسابية وتعيد النتيجة:

# دالة تجمع رقمين وتعيد الناتج
def add_numbers(x, y):
    total = x + y
    return total

# استدعاء الدالة وتخزين النتيجة في متغير
sum_result = add_numbers(10, 5)

print(f"ناتج الجمع هو: {sum_result}")
print(f"يمكننا استخدام الناتج في عملية أخرى: {sum_result * 2}")

الناتج:

ناتج الجمع هو: 15
يمكننا استخدام الناتج في عملية أخرى: 30

الدوال التي تعيد قيماً (return) هي الأكثر شيوعاً وقوة، لأنها تسمح لنا ببناء برامج معقدة عبر ربط مخرجات دالة كمدخلات لدالة أخرى.

5. توثيق الدوال (Docstrings)

من الممارسات الجيدة أن تصف ما تفعله الدالة داخلها مباشرةً. هذا يساعدك (ويساعد المبرمجين الآخرين) على فهم الغرض من الدالة دون الحاجة لقراءة كل أسطر الكود. يتم ذلك باستخدام ما يسمى سلسلة التوثيق النصية (Docstring)، وهي نص تضعه بين ثلاث علامات اقتباس مزدوجة """ في بداية الدالة مباشرة.

def calculate_average(numbers):
    """
    تحسب هذه الدالة المتوسط الحسابي لقائمة من الأرقام.
    تأخذ قائمة أرقام كمدخل (list) وتعيد المتوسط (float).
    إذا كانت القائمة فارغة، تعيد 0.
    """
    if not numbers:
        return 0
    
    total = sum(numbers)
    average = total / len(numbers)
    return average

# الآن يمكننا استخدام الدالة
grades = [85, 90, 78, 92]
avg = calculate_average(grades)
print(f"المتوسط هو: {avg}")

هذه العادة ستكون مفيدة جداً عندما تبدأ في بناء مشاريع أكبر، مثل وكلاء الذكاء الاصطناعي.

لترسيخ المفاهيم والمصطلحات الجديدة التي تعلمناها، يمكنك قراءة هذه المقالة كمرجع.

def get_product_status(product_dict):
    """
    تفحص هذه الدالة حالة توفر منتج بناءً على قاموس معلوماته.
    """
    product_name = product_dict['name']
    product_quantity = product_dict['quantity']

    if product_quantity > 0:
        return f'"{product_name}" متوفر في المخزون.'
    else:
        return f'"{product_name}" غير متوفر حالياً.'

# إنشاء بيانات المنتجات
product1 = {'name': 'لابتوب', 'quantity': 15}
product2 = {'name': 'شاشة عرض', 'quantity': 0}

# استدعاء الدالة لكل منتج وطباعة النتيجة
status1 = get_product_status(product1)
print(status1)

status2 = get_product_status(product2)
print(status2)

"لابتوب" متوفر في المخزون.
"شاشة عرض" غير متوفر حالياً.

ملخص الدرس

ممتاز! لقد أضفت اليوم إلى صندوق أدواتك البرمجية واحدة من أهم الأدوات على الإطلاق.

• الدوال (Functions) هي كتل من الكود القابل لإعادة الاستخدام، تساعدنا على تنظيم برامجنا وتجنب التكرار.
• نُعرّف الدالة باستخدام الكلمة المفتاحية def.
• نستدعي الدالة بكتابة اسمها متبوعاً بقوسين ().
• يمكننا تمرير بيانات للدالة عبر المعاملات (Parameters).
• يمكن للدالة أن تعيد نتيجة باستخدام الكلمة المفتاحية return.

ما التالي؟

الآن بعد أن تعلمنا كيفية كتابة الدوال، ماذا يحدث إذا حاول مستخدم برنامجنا إدخال قيمة خاطئة؟ أو إذا فشلت الدالة في أداء مهمتها لسبب ما؟ حالياً، سينهار البرنامج ويتوقف. في الدرس القادم، سنتعلم كيفية التعامل مع هذه الأخطاء بأناقة باستخدام كتل try/except، مما يجعل برامجنا أكثر قوة ومتانة.