التابع 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:
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.