عرض مصدر Kotlin/run

<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎run()‎</code> في Kotlin}}</noinclude>
يمكن استخدام الدالة <code>run()‎</code> بطريقتين:
* استدعاء بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كمستقبِلٍ (receiver) له وإعادة قيمة ناتج البنية.
* استدعاء بنية (block) الدالة المُحدَّدة وإعادة ناتجها.

== البنية العام ==
<syntaxhighlight lang="kotlin">
inline fun <T, R> T.run(block: T.() -> R): R

inline fun <R> run(block: () -> R): R
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].

== المعاملات ==

=== <code>block</code> ===
الكتلة البرمجية المراد استدعاؤها وتنفيذها.

== القيم المعادة ==
يعاد ناتج بنية (block) الدالة المُحدَّدة في المعامل <code>block</code>.

== أمثلة ==
'''مثالٌ على استخدام الدالة <code>run()‎</code> وفق الشكل الاول:'''

تستدعي الشيفرة الآتية الدالة <code>run()‎</code> عبر الكائن <code>person</code> المُنشَأ من الصنف <code>Person</code> الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (name) والعمر(age) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة ثم سيُعاد ناتج بنية (block) الدالة إلى المتغير <code>a</code>:<syntaxhighlight lang="kotlin">
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
}
</syntaxhighlight>'''مثالٌ على استخدام الدالة <code>run()‎</code> وفق الشكل الثاني:'''

تستخدم الشيفرة الآتية الدالة <code>run()</code>‎ لتنفيذ بنية (block) برمجية تُعرّف متغيرين باسم <code>name</code> و <code>age</code> ثم تطبع قيمتيهما:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    run {
        val name = "أحمد"
        val age = 14
        print(message = name + " " + age) // أحمد 14
    }
}
</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>[[Kotlin/apply|()apply]]</code>: تستدعي بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كمستقبِلٍ (receiver) لها وتُعيد قيمة <code>this</code>.

== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/run.html صفحة الدالة run()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]