معاملات Rest (Rest Parameters) وتحميل الدوال الزائد (Function Overloading) في TypeScript

مقدمة حول معاملات Rest وتحميل الدوال الزائد

في TypeScript، تعتبر معاملات Rest طريقة قوية ومرنة للتعامل مع عدد متغير من الوسائط لدالة معينة. تُستخدم معاملات Rest لتمثيل مصفوفة من الوسائط ويمكن استخدامها بطرق متنوعة في تطبيقاتك.

مفهوم معاملات Rest

معاملات Rest هي نوع خاص من المعاملات يُستخدم للتعامل مع عدد متغير من الوسائط لدالة معينة. في JavaScript، يمكن استخدام الرمز ... لتمثيل معاملات Rest.

function sumParams(...rest: any[]) {
    // الدالة تأخذ الوسائط الغير معروفة العدد وتضيفها إلى نتيجة الجمع
    let result = 0;
    for (const param of rest) {
        result += param;
    }
    return result;
}

استخدام معاملات Rest في TypeScript

في TypeScript، يتم تعريف معاملات Rest لتحديد أنواع المدخلات المجمعة بدقة. فيما يلي مثال لاستخدام معاملات Rest:

function sumParams(...rest: number[]) {
    // الدالة تأخذ الوسائط الغير معروفة العدد وتضيفها إلى نتيجة الجمع
    let result = 0;
    for (const param of rest) {
        result += param;
    }
    return result;
}

// استخدام الدالة sumParams مع وسائط مختلفة
console.log(sumParams(1, 2, 3, 4, 5)); // النتيجة: 15
console.log(sumParams(1, 2, sumParams(3, 4, 5))); // النتيجة: 15

تحميل الدوال الزائد في TypeScript

في TypeScript، يمكننا استخدام مفهوم تحميل الدوال الزائد للسماح لدالة معينة بالتعامل مع عدد متفاوت من الوسائط. هذه الخاصية توفر مرونة أكبر عند التعامل مع أنواع مختلفة من الوسائط:

function multiply(...args: number[]): number;
function multiply(...args: string[]): string;
function multiply(...args: any[]): any {
    if (typeof args[0] === 'number') {
        let result = 1;
        for (const arg of args) {
            result *= arg;
        }
        return result;
    } else {
        let result = '';
        for (const arg of args) {
            result += arg + ' ';
        }
        return result.trim();
    }
}

// استخدام الدوال multiply مع وسائط مختلفة
console.log(multiply(1, 2, 3, 4)); // النتيجة: 24
console.log(multiply(1, 2, multiply(3, 4, 5))); // النتيجة: 120
console.log(multiply('a', 'b', 'c')); // النتيجة: a b c
console.log(multiply(multiply('a', 'b'), multiply('c', 'd', 'e', 'f'))); // النتيجة: a b c d e f

استخدام معاملات Rest وحمولة الدوال الزائد

في TypeScript، يمكننا استخدام مفهوم تحميل الدوال الزائد للسماح لدالة معينة بالتعامل مع عدد متفاوت من الوسائط. هنا سنسرد بعض الأمثلة لتوضيح استخدام معاملات Rest وحمولة الدوال الزائد.

• Difference Between Rest Parameters and Function Overloading
• Using Rest Parameters in TypeScript
• Using Function Overloading for Differences Number and String Args

مثال على معاملات Rest:

لنأخذ مثالاً على استخدام معاملات Rest في TypeScript:

function multiply(...args: number[]): number {
    // تأخذ هذه الدالة معاملات Rest وتعيد النتيجة المتضاعفة لجميع الوسائط المعطاة
    let result = 1;
    for (let i = 0; i < args.length; i++) {
        result *= args[i];
    }
    return result;
}

console.log(multiply(1, 2, multiply(3, 4, 5))); // النتيجة: 120

مثال على تحميل الدوال الزائد:

في هذا المثال، سنوضح كيف يمكن استخدام تحميل الدوال الزائد للتعامل مع أنواع مختلفة من الوسائط:

function multiply(a: number, b: number): number;
function multiply(a: string, b: string): string;
function multiply(a: any, b: any): any {
    if (typeof a === "number" && typeof b === "number") {
        return a * b;
    }
    return a + " " + b;
}

console.log(multiply(1, 2)); // النتيجة: 2
console.log(multiply('a', 'b')); // النتيجة: a b

مثال على معاملات Rest وحمولة الدوال الزائد:

في هذا المثال، سنوضح كيفية دمج معاملات Rest وحمولة الدوال الزائد للتعامل مع أنواع وسائط مختلفة:

function multiply(a: number, b: number): number;
function multiply(a: string, b: string): string;
function multiply(a: string, b: string, c: string): string;
function multiply(a: any, b: any, c?: any): any {
    if (typeof a === "number") {
        return a * b;
    }
    return c ? `${a} ${b} ${c}` : `${a} ${b}`;
}

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

بعد أن تعرفنا في القسم السابق على المفهوم العام لمعاملات Rest ودورها المحوري في التعامل مع عدد غير محدد من المعاملات، ننتقل الآن لاستكشاف كيفية تعريفها واستخدامها عملياً داخل دوال TypeScript. تُعد معاملات Rest أداة قوية تُمكّن المطورين من كتابة دوال أكثر مرونة وقابلية لإعادة الاستخدام.

معاملات الافتراضية (Variadic Functions)

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

في هذا القسم، سنتعرف على مفهوم معاملات الافتراضية (Variadic Functions) وكيفية استخدامها في تعريف الدوال. معاملات الافتراضية تسمح لنا بتعريف دالة يمكنها التعامل مع أي عدد من الوسائط الإضافية بعد الوسائط الأساسية للدالة.

الفرق بين المعاملات الافتراضية والمعاملات الغير محددة

لتمييز المعاملات الافتراضية عن المعاملات الغير محددة، يمكننا استخدام الرمز ... قبل اسم المعامل.

التعامل مع المعاملات الزائدة

عندما نمرر معاملات إضافية تتجاوز حد المعلمات الأساسية للدالة، سيتم التعامل معها كمصفوفة.

مثال على معاملات الافتراضية

لنفترض أن لدينا دالة تسمى addItems تأخذ عدداً من المعاملات وتضيفها معاً:

function addItems(...items: number[]) {
  let sum = 0;

  items.forEach(item => sum += item);

  return sum;
}

في هذا المثال، قمنا بتعريف دالة addItems التي تقبل المعاملات الافتراضية ...items. تستطيع هذه الدالة التعامل مع أي عدد من الوسائط number[] بعد الوسائط الأساسية function addItems(...items: number[]). يتم تخزين العناصر المنقولة في مصفوفة items ومن ثم يتم جمع العناصر باستخدام حلقة forEach.

استخدام معاملات الافتراضية في دالة

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

استخدام معاملات الافتراضية مع المعاملات الأساسية

لنفترض أن لدينا دالة تسمى addNumbers تأخذ الأعداد الصحيحة كوسائط:

function addNumbers(a: number, b: number) {
  return a + b;
}

في هذه الدالة، لدينا وسيطين أساسيين هما a و b. لكن ماذا لو أردنا إضافة عدة أعداد صحيحة دفعة واحدة؟ يمكننا تعديل الدالة لتتضمن معامل افتراضي:

function addNumbers(a: number, b: number, ...numbers: number[]): number {
  let result = a + b;

  numbers.forEach(number => result += number);

  return result;
}

const num1 = 5;
const num2 = 10;
const numbers = [2, 3, 4, 5];

console.log(addNumbers(num1, num2, ...numbers)); // الناتج: 29

في هذا المثال، قمنا بتعريف ثلاثة متغيرات num1 و num2 و numbers. ثم استخدمنا دالة addNumbers لإضافة القيم الموجودة في مصفوفة numbers والمعاملات الأساسية num1 و num2. الناتج من العملية سيكون 29.

معاملات الافتراضية والمعاملات الأساسية

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

استخدام معاملات الافتراضية في دالة معقدة

لنفترض أننا نريد كتابة دالة تقوم بعملية حسابية معقدة تتعامل مع معاملات متعددة:

function multiplyNumbers(a: number, b: number, ...numbers: number[]): number {
  let result = a * b;

  numbers.forEach(number => result *= number);

  return result;
}

في هذا المثال، قمنا بتعريف دالة تسمى multiplyNumbers وتتعامل مع ثلاث معاملات: a و b و numbers وهي مصفوفة من الأعداد الصحيحة.

معاملات الافتراضية والمعاملات الأساسية مع المعامل الاختياري

في هذا المثال، قمنا بتعريف دالة تسمى multiplyNumbers وتتعامل مع أربع معاملات: a و b و numbers و i وهي معامل اختياري:

function multiplyNumbers(a: number, b: number, numbers: number[], i: number = 0): number {
  let result = a * b;

  numbers.forEach(number => result *= number);

  return result;
}

شرح المعاملات الافتراضية

في هذا القسم، سنتعمق أكثر في مفهوم المعاملات الافتراضية وكيفية التعامل معها:

• المعاملات الافتراضية هي معاملات اختيارية يمكن تعيين قيمتها إلى المعامل الأساسي للدالة.
• لاستخدام المعاملات الافتراضية، يمكننا تعيين المعامل الأساسي للدالة إلى قيمة افتراضية.
• في حالة تمرير معاملات إضافية تتجاوز المعاملات الافتراضية، سيتم التعامل معها كمعاملات أساسية.
• يمكن استخدام معاملات متعددة لزيادة مرونة الدوال.

معاملات Rest والمعامل الافتراضي | TypeScript

في هذا المقال، سنتعرف على مفهومين مهمين في لغة TypeScript وهما معاملات Rest وRest Parameter. سنتناول كيفية استخدام هذه المفاهيم لتحسين مرونة الدوال والتعامل مع المعاملات المتعددة.

معاملات Rest:

• معاملات Rest (Rest Parameter)، المعروفة أيضاً بمعامل الـ”…”، تسمح لنا بجمع عدة معاملات وربطها معاً في مجموعة واحدة بعد الدالة.
• معاملات Rest هي طريقة لجمع المعاملات غير المعروفة العدد.
• يمكن استخدام معاملات Rest لجمع المعاملات التي قد يختلف عددها.
• تساعد معاملات Rest في التعامل مع المعاملات الزائدة بكفاءة.

المعامل الافتراضي:

• المعامل الافتراضي (Virtual Parameter)، المعروف أيضاً بمعامل الـ”…”، يتيح لنا إنشاء دوال بقيم افتراضية للمعاملات غير المعرفة.
• يوفر المعامل الافتراضي طريقة للتعامل مع المعاملات الغير معرفة مسبقاً.
• يساعد المعامل الافتراضي في تحسين مرونة الكود وتقليل الأخطاء الناتجة عن نسيان المعاملات.
• يمكن استخدام المعامل الافتراضي للتعامل مع المعاملات الاختيارية وتوفير قيم افتراضية لها.

تطبيقات عملية:

في هذا القسم، سنرى كيف يمكن تطبيق معاملات Rest والمعامل الافتراضي في أمثلة عملية:

• مثال على استخدام معاملات Rest لجمع المعاملات.
• مثال على استخدام المعامل الافتراضي للتعامل مع المعاملات الغير معرفة.
• مناقشة الفروقات بين معاملات Rest ومعاملات Parameters العادية.

معاملات Rest: الجمع بين الراحة والمرونة

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

• فهم مفهوم معاملات Rest واستخدامها لجمع المعاملات.
• تعلم كيفية تحديد القيم الافتراضية للمعلمات من خلال معاملات Rest.
• مثال عملي لتوضيح استخدام معاملات Rest في جمع المعاملات.

المعامل الافتراضي: تحسين مرونة الكود وتقليل الأخطاء

المعامل الافتراضي (Virtual Parameter) هو معامل يسمح لنا بالتعامل مع المعاملات الغير معرفة مسبقاً بطريقة مريحة ومنظمة. في هذا القسم، سنرى كيف يمكن استخدام المعامل الافتراضي للتعامل مع المعاملات الغير معرفة وتحسين مرونة الكود:

• فهم مفهوم المعامل الافتراضي وأهميته في تحسين مرونة الكود.
• شرح كيفية استخدام المعامل الافتراضي للتعامل مع المعاملات الغير معرفة.
• تسليط الضوء على فوائد استخدام المعامل الافتراضي في تقليل الأخطاء وتحسين تنظيم الكود.

الفروقات بين معاملات Rest ومعاملات الـ Parameters العادية

في هذا القسم، سنتعرف على الفروقات بين معاملات Rest ومعاملات الـ Parameters العادية:

• تمييز معاملات Rest عن المعاملات العادية.
• شرح كيفية تحديد القيم الافتراضية للمعلمات باستخدام معاملات Rest.
• مقارنة بين معاملات Rest ومعاملات المعلمات العادية من حيث المرونة والكفاءة.

استنتاج ومراجعة

في هذا القسم، سنلخص المعلومات المقدمة ونستعرض النتائج الرئيسية:

• استنتاج حول معاملات Rest والمعامل الافتراضي.
• مراجعة الفروقات بين معاملات Rest والمعلمات العادية.
• توصيات لتحسين كفاءة الكود والتعامل مع المعاملات.

معاملات Rest وتحميل الدوال الزائد (Part 1)

في هذا الدرس، سنتعرف على مفهوم تحميل الدوال الزائد ومعاملات Rest في TypeScript. سنستكشف كيفية استخدام هذه الميزات القوية لبناء دوال TypeScript أكثر مرونة وفعالية.

معاملات Rest (Part 1)

معاملات Rest هي ميزة تتيح لك جمع مجموعة من المعاملات ذات الأنواع المختلفة في قيمة واحدة مجمعة. في TypeScript، تُستخدم معاملات Rest لتمرير مصفوفة أو كائن أو سلسلة من الوسائط إلى الدالة.

تجميع المعاملات باستخدام معاملات Rest

لتجميع المعاملات باستخدام معاملات Rest:

• الخطوة 1: تحديد الدالة وتحديد المعاملات المطلوبة.
• الخطوة 2: استخدام معاملات Rest لتجميع المعاملات.
• الخطوة 3: التعامل مع المعاملات المجمعة.

على سبيل المثال، دعنا نراجع الكود التالي:

function sampleFunction(arg1: string, arg2: number, args: string[]): string {
    return "تم تمرير المعاملات بنجاح";
}

في هذا المثال، لدينا دالة تسمى “sampleFunction” تأخذ ثلاثة معاملات: string وnumber وstring[].

تحميل الدوال الزائد (Part 1)

في TypeScript، يتم استخدام تحميل الدوال الزائد لتمكين الدوال من التعامل مع معاملات مختلفة بعدد وأنواع مختلفة. يتيح لك ذلك توفير دوال متعددة تحقق نفس الغرض ولكن بمعلمات متنوعة لتلبية متطلبات المستخدمين المختلفة.

تحديد الدوال الزائد

لتحديد دالة بزيادة تحميل (Overload)، نقوم بكتابة التوقيعات أولاً:

function multiply(a: number, b: number): number;
function multiply(a: number, b: number): string;
function multiply(a: number, b: number): any {
    return a * b;
}

استخدام معاملات Rest في الدوال

معامل Rest (Rest Parameters) هو معامل يتيح لك تجميع المعاملات ذات الأنواع المختلفة في نوع مجمع واحد:

function multiplyRest(...numbers: number[]): number[] {
    return numbers.map(number => number * 2);
}

في الدالة multiplyRest()، نستخدم معامل Rest ...numbers لجمع المعاملات العددية ومن ثم نطبق عملية الضرب على كل معامل ونجمع النتائج في مصفوفة جديدة. يمكنك استخدام هذه الدالة لجمع معاملات وتطبيق العمليات الحسابية عليها.

فهم أولوية الدوال الزائدة مع معاملات Rest

في TypeScript، تعتبر أولوية الدوال ميزة مهمة لضمان تعريف الدالة التي ستُستخدم عند استدعاء الدالة. عند استدعاء دالة زائدة الاستخدام مع معاملات Rest، يتم تحديد الدوال ذات الأولوية الأعلى بناءً على ترتيب تعريف التوقيعات من الأعلى إلى الأسفل.

function multiplyRest(...numbers: number[]): number[];
function multiplyRest(...numbers: string[]): string[];
function multiplyRest(...numbers: any[]): any[] {
    return numbers.map(number => number * 2);
}

معاملات Rest وتحميل الدوال الزائد (Part 2)

في هذا القسم، سنكمل مناقشة معاملات Rest وتحميل الدوال الزائد في لغة TypeScript. سنتعرف على كيفية استخدام معاملات Rest لتحديد عدد ونوع المعاملات المطلوبة لدالة معينة والتعامل مع المعاملات الزائدة. سنتناول أيضاً مفهوم التحميل الزائد وكيفية استخدامه لتحسين الدوال والتعامل مع أنواع مختلفة من المعاملات.

القواعد الأساسية لمعامل Rest

في TypeScript، يمكن تعريف معامل Rest باستخدام الرمز ... قبل اسم المعامل. على سبيل المثال:

function sum(...numbers: number[]): number {
  let total = 0;
  numbers.forEach(number => total += number);
  return total;
}

في المثال السابق، قمنا بتعريف دالة تسمى “sum” تأخذ المعاملات الزائدة “numbers” من نوع “number[]” وتتعامل مع المعاملات باستخدام طريقة “forEach()”. يتم جمع قيم المعاملات الزائدة وإضافتها إلى متغير “total”. وأخيراً، يتم إرجاع القيمة الإجمالية.

المفاهيم المتقدمة: التطبيق الجزئي والدوال المترابطة (Curried & Partial Application)

في TypeScript، يمكنك استخدام معاملات Rest لدعم أنماط برمجية متقدمة تشمل:

• التعامل مع المعاملات الزائدة باستخدام المعاملات العادية: تحديد الوسائط الإلزامية أولاً ثم ترك الباقي لـ Rest.
• التطبيق الجزئي للدوال (Partial Function Application): تثبيت بعض المعاملات واستقبال الباقي عبر معاملات Rest.
• الدوال المترابطة (Curried Functions): تفكيك الدوال متعددة الوسائط لتصبح سلسلة دوال أحادية الوسيط بمساعدة معاملات Rest.
• تحليل المعاملات الزائدة (Argument Unpacking): تمرير مصفوفات إلى دوال التحميل الزائد باستخدام Spread Operator.

معاملات Rest وتحميل الدوال الزائد (Part 3)

في هذا الجزء الثالث من سلسلتنا، نناقش كيفية استخدام هذه المفاهيم معاً لتحسين مرونة دوالك والتعامل مع المعاملات الزائدة بطريقة فعالة:

• معاملات Rest: تتيح لك جمع مجموعة من المعاملات بطريقة مرنة، حيث يمكنك تحديد عدد المعاملات المطلوبة وطريقة التعامل معها بناءً على متطلبات الدالة.
• تحميل الدوال الزائد: يسمح لك بكتابة دوال بالاسم نفسه ولكن بتعريفات مختلفة للتعامل مع أعداد وأنواع معاملات مختلفة.
• دمج المفهومين معاً: يوفر حلاً متكاملاً لزيادة المرونة، وتحسين قراءة الكود، وتقليل الأخطاء عند استدعاء الدوال المتعددة الوسائط.

معاملات Rest وتحميل الدوال الزائد (Part 4)

بعد أن استكشفنا بعمق مفاهيم معاملات Rest وتحميل الدوال الزائد كل على حدة، حان الوقت لنتعمق في القوة الحقيقية التي تنشأ عند دمج هاتين الميزتين الرائعتين في TypeScript. إن الجمع بين معاملات Rest التي تتيح استقبال مصفوفات ديناميكية من الوسائط، مع توقيعات التحميل الزائد التي تفرض فحص الأنواع بدقة عند الاستدعاء، يمثل ذروة المرونة البرمجية والأمان النوعي في بناء واجهات الدوال المعقدة.

معاملات Rest وتحميل الدوال الزائد (Part 5)

معاملات Rest هي ميزة مهمة في لغة TypeScript تسمح لنا بتمرير مصفوفة من القيم إلى الدالة كمعامل واحد، وتستخدم لتجميع المعاملات الزائدة للدالة والتعامل معها بطريقة موحدة ومنظمة. في حين أن تحميل الدوال الزائد يتيح للدالة التعامل مع عدد ونوع مختلف من المعاملات.

أمثلة توضيحية وحالات الاستخدام

• معاملات Rest في TypeScript: حساب مجموع الأعداد من مصفوفة عبر تجميع الأعداد وجمعها بطريقة فعالة ومنظمة.
• تحميل الدوال الزائد في TypeScript: تحويل سلسلة معينة إلى حروف صغيرة أو حروف كبيرة بناءً على معاملات اختيارية.
• الجمع بين معاملات Rest وتحميل الدوال الزائد: حساب المساحة والمحيط لشكل مخصص بناءً على معاملات متعددة.

دراسة حالة تطبيقية: دالة لحساب مساحة ومحيط الشكل المخصص

سنقدم دالة متكاملة تتعامل مع الأشكال المخصصة وحسابات المساحة والمحيط بناءً على المعاملات المطلوبة. يعكس الكود استخدام معاملات Rest وتحميل الدوال الزائد معاً بطريقة مرنة:

interface ShapeMetrics {
    area: number;
    perimeter: number;
}

// توقيع الدائرة
function calculateCustomShape(type: "circle", radius: number): ShapeMetrics;

// توقيع المستطيل
function calculateCustomShape(type: "rectangle", length: number, width: number): ShapeMetrics;

// توقيع المضلع المخصص مع معاملات Rest لحساب المحيط
function calculateCustomShape(type: "polygon", ...sides: number[]): ShapeMetrics;

// كود الدالة التنفيذي الجامع
function calculateCustomShape(type: string, ...args: number[]): ShapeMetrics {
    if (type === "circle") {
        const radius = args[0];
        return {
            area: Math.PI * radius * radius,
            perimeter: 2 * Math.PI * radius
        };
    } else if (type === "rectangle") {
        const [length, width] = args;
        return {
            area: length * width,
            perimeter: 2 * (length + width)
        };
    } else if (type === "polygon") {
        const perimeter = args.reduce((sum, side) => sum + side, 0);
        return {
            area: 0,
            perimeter: perimeter
        };
    }
    throw new Error("نوع الشكل غير مدعوم");
}

console.log(calculateCustomShape("circle", 5));
console.log(calculateCustomShape("rectangle", 10, 4));
console.log(calculateCustomShape("polygon", 3, 4, 5, 6));

استنتاج الدرس

في هذا الدرس، تعرفنا على معاملات Rest وتحميل الدوال الزائد وكيفية استخدامها لتحسين أداء الدوال والتعامل مع المعاملات الزائدة بطريقة مرنة وفعالة. لقد تعلمت كيفية استخدام معامل Rest للتعامل مع المعاملات الزائدة وتحميل الدوال الزائد لتحديد المعاملات المناسبة للحساب.

مراجع ومصادر مفيدة للتعلم

• كتاب TypeScript for Dummies: يشرح أساسيات TypeScript ومفاهيم معاملات Rest وتحميل الدوال الزائد.
• مقالة “معاملات Rest وتحميل الدوال الزائد في TypeScript”: توفر شرحاً مفصلاً حول معاملات Rest وتحميل الدوال الزائد.
• الدورة التعليمية “تعلم TypeScript من الصفر”: تشرح أساسيات TypeScript والتطبيق العملي لتحميل الدوال الزائد.
• كتاب “فهم TypeScript: فهم أساسي لـ TypeScript وميزات TypeScript المتقدمة”: يشرح أساسيات TypeScript والميزات المتقدمة وتطبيقاتها البرمجية.