Kotlin/run

يمكن استخدام 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:

fun main(args: Array<String>) {

   val person = Person()

   val a = person.run {

       name = "bob"

       age = 19

       name + " " + age

}

       println(a) // bob 19

}

class Person {

   var name = "kim"

   var age = 52

}

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

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

fun main(args: Array<String>) {

   run ({

       val name = "ryo"

       val age = 14

       print (name + " " + age)  // ryo 14

   })   

}

انظر أيضًا

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

مصادر

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