الدالة run()‎ في Kotlin

يمكن استخدام الدالة run()‎ بطريقتين:

• استدعاء بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كمستقبِلٍ (receiver) له وإعادة قيمة ناتج البنية.
• استدعاء بنية (block) الدالة المُحدَّدة وإعادة ناتجها.

البنية العام

الشكل الأول

inline fun <T, R> T.run(block: T.() -> R): R

الشكل الثاني

inline fun <R> run(block: () -> R): R

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

القيم المعادة

ناتج بنية (block) الدالة المُحدَّدة.

أمثلة

استخدام الدالة run()‎ وفق الشكل الاول

تستدعي الشيفرة الآتية الدالة run()‎ عبر الكائن person المُنشَأ من الصنف Person الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (name) والعمر(age) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة ثم سيُعاد ناتج بنية (block) الدالة إلى المتغير a:

class Person {
    var name = "أحمد"
    var age = 52
}

fun main(args: Array<String>) {
    val person = Person()
    val a = person.run {
        name = "ناصر"
        age = 19
        name + " " + age
    }
    println(a) // ناصر 19
}

استخدام الدالة run()‎ وفق الشكل الثاني

تستخدم الشيفرة الآتية الدالة run()‎ لتنفيذ بنية (block) برمجية تُعرّف متغيرين باسم name و age ثم تطبع قيمتيهما:

fun main(args: Array<String>) {
    run {
        val name = "أحمد"
        val age = 14
        print(message = name + " " + age) // أحمد 14
    }
}

انظر أيضًا

• الدالة ()apply: تستدعي بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كمستقبِلٍ (receiver) لها وتُعيد قيمة this.

مصادر

• صفحة الدالة run()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.