Menu
Coddy logo textTech
flag Ar iconالعربيةdown icon

المعاملات المسماة المطلوبة

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

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

أنشئ دالة بمعاملات مسماة مطلوبة:

void createUser({required String name, required int age}) {
  print('User created: $name, $age years old');
}

استدعِ الدالة مع جميع المعلمات المطلوبة:

void main() {
  createUser(name: 'Alex', age: 30);
}

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

User created: Alex, 30 years old

إذا حاولت حذف معلمة مطلوبة، سيعرض Dart خطأً:

// سيؤدي هذا إلى حدوث خطأ:
// createUser(name: 'Alex'); // معلمة مطلوبة مفقودة 'age'
challenge icon

التحدي

مبتدئ

في هذا التحدي، ستتدرب على استخدام الكلمة المفتاحية required مع المعلمات المسماة في Dart. تضمن الكلمة المفتاحية required وجوب توفير المعلمة المسماة عند استدعاء الدالة.

أكمل الدالة createUserProfile عن طريق إضافة الكلمة المفتاحية required لجعل كل من المعلمتين name و age مطلوبتين.

ورقة مرجعية

تُجبر الكلمة المفتاحية required على توفير المعاملات المسماة عند استدعاء دالة. وبدونها، تكون المعاملات المسماة اختيارية بشكل افتراضي.

أنشئ دالة بمعاملات مسماة مطلوبة:

void createUser({required String name, required int age}) {
  print('User created: $name, $age years old');
}

استدعِ الدالة بجميع المعاملات المطلوبة:

createUser(name: 'Alex', age: 30);

سيؤدي حذف معامل مطلوب إلى حدوث خطأ في التجميع (compilation error).

جرّب بنفسك

void main() {
  // استدعاء هذه الدالة معدّ مسبقاً لك
  String profile = createUserProfile(name: 'Alice', age: 30);
  print(profile);
  
  // قم بإلغاء تعليق هذا السطر لترى ما يحدث عندما تكون المعاملات المطلوبة مفقودة
  // String invalidProfile = createUserProfile(name: 'Bob');
}

// TODO: أضف الكلمة المفتاحية 'required' لجعل كلا المعاملين مطلوبين
String createUserProfile({String name, int age}) {
  return 'User Profile: $name, $age years old';
}
quiz iconاختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

جميع دروس Fundamentals