التحميل الزائد للدوال (Function Overloading)

جزء من قسم Object Oriented Programming في رحلة C++ على Coddy — الدرس 57 من 104.

تحميل الدوال الزائد (Function overloading) يتيح لك تعريف دوال متعددة بنفس الاسم ولكن بقوائم معلمات مختلفة. يختار المترجم (compiler) النسخة الصحيحة بناءً على الوسائط (arguments) التي تمررها. يعد هذا شكلاً أساسياً من أشكال تعدد الأشكال في وقت الترجمة (compile-time polymorphism).

لكي يعمل التحميل الزائد (overloading)، يجب أن تختلف الدوال في توقيعها (signature) - عدد المعاملات، أو أنواعها، أو كليهما:

class Calculator {
public:
    int add(int a, int b) {
        return a + b;
    }
    
    double add(double a, double b) {
        return a + b;
    }
    
    int add(int a, int b, int c) {
        return a + b + c;
    }
};

Calculator calc;
calc.add(5, 3);        // يستدعي add(int, int)
calc.add(2.5, 3.7);    // يستدعي add(double, double)
calc.add(1, 2, 3);     // يستدعي add(int, int, int)

يفحص المترجم كل استدعاء ويطابقه مع التحميل الزائد (overload) المناسب. يحدث هذا بالكامل في وقت الترجمة، لذا لا يوجد عبء إضافي في وقت التشغيل.

هام: نوع الإرجاع وحده لا يميز الدوال المحملة بشكل زائد (overloaded functions). سيؤدي ما يلي إلى خطأ في المترجم (compiler error):

int getValue();
double getValue();  // خطأ: لا يمكن التحميل الزائد بناءً على نوع الإرجاع فقط

يجعل التحميل الزائد للدوال (Function overloading) الكود الخاص بك أكثر سهولة وفهماً. فبدلاً من إنشاء أسماء منفصلة مثل addInts و addDoubles و addThreeInts، يمكنك استخدام اسم واحد ذي معنى وترك المهمة للمترجم (compiler) للتعامل مع الباقي.

التحدي

سهل

لنقم ببناء فئة منسق رسائل (message formatter) توضح قوة تحميل الدوال الزائد (function overloading). ستقوم بإنشاء فئة Formatter تحتوي على عدة دوال format() تتعامل مع أنواع مختلفة من المدخلات، مما يسمح للمترجم (compiler) باختيار الإصدار الصحيح بناءً على ما تمرره.

ستقوم بتنظيم الكود الخاص بك عبر ملفين:

Formatter.h: قم بتعريف فئة Formatter مع دوال format() محملة بشكل زائد تتعامل مع سيناريوهات مختلفة:
- دالة تأخذ std::string واحداً وتطبع: Message: <text>
- دالة تأخذ std::string ومستوى أولوية من نوع int، وتطبع: [Priority <priority>] <text>
- دالة تأخذ std::string وطابعاً زمنياً من نوع double، وتطبع: [<timestamp>s] <text>
- دالة تأخذ ثلاث معاملات من نوع std::string (المرسل، المستقبل، الرسالة) وتطبع: From <sender> to <receiver>: <message>
يجب تسمية جميع الدوال باسم format() — سيختار المترجم الدالة الصحيحة بناءً على الوسائط (arguments).
main.cpp: اقرأ أربعة مدخلات (كل منها في سطر منفصل):
1. نص رسالة بسيط
2. مستوى أولوية (عدد صحيح)
3. طابع زمني (عدد عشري)
4. اسم المرسل
قم بإنشاء كائن Formatter واستعرض جميع الدوال الأربع المحملة بشكل زائد:
- استدعِ format() بنص الرسالة فقط
- استدعِ format() بنص الرسالة والأولوية
- استدعِ format() بنص الرسالة والطابع الزمني
- استدعِ format() مع المرسل، و "Admin" كمستقبل، ونص الرسالة

على سبيل المثال، مع المدخلات System ready، و 3، و 12.5، و Server:

Message: System ready
[Priority 3] System ready
[12.5s] System ready
From Server to Admin: System ready

لاحظ كيف تستدعي نفس اسم الدالة format() أربع مرات، ولكن كل استدعاء ينفذ إصداراً مختلفاً بناءً على أنواع الوسائط وعددها. هذا هو تعدد الأشكال في وقت التجميع (compile-time polymorphism) — حيث يحدد المترجم أي تحميل زائد سيستخدمه قبل تشغيل البرنامج.

ورقة مرجعية

يسمح لك التحميل الزائد للدوال (Function overloading) بتعريف دوال متعددة بنفس الاسم ولكن بقوائم معلمات مختلفة. يختار المترجم (compiler) الإصدار الصحيح بناءً على الوسائط الممرة في وقت الترجمة.

يجب أن تختلف الدوال في توقيعها (signature) - عدد المعلمات، أو أنواعها، أو كليهما:

class Calculator {
public:
    int add(int a, int b) {
        return a + b;
    }
    
    double add(double a, double b) {
        return a + b;
    }
    
    int add(int a, int b, int c) {
        return a + b + c;
    }
};

Calculator calc;
calc.add(5, 3);        // يستدعي add(int, int)
calc.add(2.5, 3.7);    // يستدعي add(double, double)
calc.add(1, 2, 3);     // يستدعي add(int, int, int)

هام: لا يمكن لنوع الإرجاع وحده التمييز بين الدوال المحملة بشكل زائد:

int getValue();
double getValue();  // خطأ: لا يمكن التحميل الزائد بناءً على نوع الإرجاع فقط

يعد التحميل الزائد للدوال شكلاً من أشكال تعدد الأشكال في وقت الترجمة (compile-time polymorphism) دون أي عبء إضافي في وقت التشغيل.

جرّب بنفسك

#include <iostream>
#include <string>
#include "Formatter.h"

using namespace std;

int main() {
    // قراءة المدخلات
    string message;
    getline(cin, message);
    
    int priority;
    cin >> priority;
    
    double timestamp;
    cin >> timestamp;
    cin.ignore();
    
    string sender;
    getline(cin, sender);
    
    // TODO: إنشاء كائن Formatter
    
    // TODO: استدعاء format() مع نص message فقط
    
    // TODO: استدعاء format() مع نص message و priority
    
    // TODO: استدعاء format() مع نص message و timestamp
    
    // TODO: استدعاء format() مع sender، و "Admin" كـ receiver، ونص message
    
    return 0;
}