Menu
CoddyTech

الوسائط المسماة

جزء من قسم الأساسيات في رحلة Kotlin على Coddy. الدرس 58 من 93.

عند استدعاء دالة ذات عدة معلمات، تمرر الوسائط عادةً بالترتيب نفسه الذي عُرّفت به تمامًا. لكن Kotlin تقدم بديلًا أكثر وضوحًا: الوسائط المُسمّاة.

باستخدام الوسائط المُسمّاة، تحدد المعلمة التي تنتمي إليها كل قيمة بكتابة اسم المعلمة متبوعًا بـ =:

fun createProfile(name: String, age: Int, city: String) {
    println("$name, $age, from $city")
}

fun main() {
    createProfile(name = "Alice", age = 25, city = "Paris")
}
// الناتج: Alice، 25، من Paris

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

// من دون وسائط مسماة - ماذا تعني هذه الأرقام؟
calculateArea(10, 5, 3)

// مع وسائط مسماة - الأمر أوضح بكثير!
calculateArea(length = 10, width = 5, height = 3)

تتيح لك الوسائط المُسمّاة أيضًا تمرير القيم بأي ترتيب تفضّله:

fun greet(firstName: String, lastName: String) {
    println("Hello, $firstName $lastName!")
}

fun main() {
    greet(lastName = "Smith", firstName = "John")
}
// الناتج: Hello, John Smith!

يمكنك مزج الوسائط الموضعية والمُسمّاة، ولكن بمجرد استخدام وسيط مُسمّى، ينبغي أن تكون جميع الوسائط التالية مُسمّاة أيضًا لتجنب الالتباس.

challenge icon

التحدي

متوسط

تُعطى الدالة التالية:

fun formatBook(title: String, author: String, year: Int) {
    println("\"$title\" by $author ($year)")
}

اقرأ ثلاث قيم إدخال: عنوان كتاب (String)، واسم مؤلف (String)، وسنة النشر (Int).

استدعِ الدالة formatBook باستخدام وسائط مسماة بهذا الترتيب المحدد: year، title، author.

على سبيل المثال، إذا كانت قيم الإدخال هي:

1984
George Orwell
1949

فيجب أن يكون الناتج:

"1984" by George Orwell (1949)

جرّب بنفسك

fun formatBook(title: String, author: String, year: Int) {
    println("\"$title\" by $author ($year)")
}

fun main() {
    val title = readLine()!!
    val author = readLine()!!
    val year = readLine()!!.toInt()
    
    // TODO: استدعِ formatBook باستخدام الوسائط المسمّاة بهذا الترتيب: year, title, author
    
}
quiz iconاختبر نفسك

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

جميع دروس الأساسيات

تدرّب بنفسك: Playground لـ Kotlin