المعاملات المسماة

جزء من قسم Fundamentals في رحلة Dart على Coddy — الدرس 73 من 94.

تتيح لك المعاملات المسماة (Named parameters) في Dart تحديد معاملات الدالة بالاسم بدلاً من الموضع. يتم تعريفها باستخدام الأقواس المتعرجة {} في إعلان الدالة.

أنشئ دالة باستخدام المعلمات المسماة (named parameters):

void greet({String name, int age}) {
  print('Hello, $name! You are $age years old.');
}

void main() {
  greet(name: 'Dart', age: 12);
}

بعد تنفيذ الكود أعلاه، ستكون النتيجة:

Hello, Dart! You are 12 years old.

عند استدعاء دالة بمعلمات مسماة (named parameters)، فإنك تحدد اسم المعلمة متبوعاً بنقطتين رأسيتين:

void main() {
  // يمكن أن تكون المعلمات بأي ترتيب
  greet(age: 30, name: 'Alice');
}

بعد تنفيذ الكود أعلاه، ستكون المخرجات:

Hello, Alice! You are 30 years old.

التحدي

مبتدئ

في هذا التحدي، ستتدرب على استخدام المعاملات المسماة (named parameters) في Dart. تجعل المعاملات المسماة استدعاءات الدوال أكثر وضوحاً من خلال تحديد أسماء المعاملات عند استدعاء الدالة.

أكمل الدالة greetUser عن طريق إضافة معاملات مسماة لـ name و age. ثم استدعِ الدالة بالقيم المقدمة.

المخرجات المتوقعة:

Hello, Alice! You are 25 years old.

ورقة مرجعية

يتم تعريف المعلمات المسماة (Named parameters) في Dart باستخدام الأقواس المتعرجة {} وتسمح لك بتحديد معلمات الدالة بالاسم بدلاً من الموضع:

void greet({String name, int age}) {
  print('Hello, $name! You are $age years old.');
}

عند استدعاء دالة بمعلمات مسماة، حدد اسم المعلمة متبوعاً بنقطتين رأسيتين. يمكن أن تكون المعلمات بأي ترتيب:

greet(name: 'Dart', age: 12);
greet(age: 30, name: 'Alice');

جرّب بنفسك

void main() {
  // هذه القيم معرفة مسبقاً لك
  String userName = 'Alice';
  int userAge = 25;
  
  // TODO: قم باستدعاء الدالة greetUser باستخدام المعاملات المسماة (named parameters)
  // قم بتمرير userName كمعامل name و userAge كمعامل age
  
  
  // الدالة معرفة في الأسفل
}

// TODO: قم بتعديل هذه الدالة لاستخدام المعاملات المسماة بدلاً من المعاملات الموضعية (positional parameters)
// تلميح: استخدم الأقواس المتعرجة {} حول المعاملات
void greetUser({required String name, required int age}) {
  print('Hello, $name! You are $age years old.');
}