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

عند استدعاء دالة تحتوي على معاملات متعددة، تمرّر عادةً الوسائط بالترتيب المحدد لها تمامًا. لكن 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!

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