الفرق بين المراجعتين ل"Kotlin/run"

المراجعة الحالية بتاريخ 06:27، 8 سبتمبر 2018

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

الكتلة البرمجية المراد استدعاؤها وتنفيذها.

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

يعاد ناتج بنية (block) الدالة المُحدَّدة في المعامل 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.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة run()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎run()‎</code> في Kotlin}}</noinclude>
-يمكن استخدام <code>run()‎</code> بطريقتين:
+يمكن استخدام الدالة <code>run()‎</code> بطريقتين:
-* كدالة، حيث يستدعي بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كمستقبِلٍ (receiver) له ويُعيد قيمة ناتج البنية.
+* استدعاء بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كمستقبِلٍ (receiver) له وإعادة قيمة ناتج البنية.
-* كدالة، حيث تستدعي بنية (block) الدالة المُحدَّدة وتعيد ناتجها.
+* استدعاء بنية (block) الدالة المُحدَّدة وإعادة ناتجها.
 == البنية العام ==
-=== الشكل الأول ===
 <syntaxhighlight lang="kotlin">
 inline fun <T, R> T.run(block: T.() -> R): R
-</syntaxhighlight>
-=== الشكل الثاني ===
-<syntaxhighlight lang="kotlin">
 inline fun <R> run(block: () -> R): R
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+== المعاملات ==
+=== <code>block</code> ===
+الكتلة البرمجية المراد استدعاؤها وتنفيذها.
 == القيم المعادة ==
-ناتج بنية (block) الدالة المُحدَّدة.
+يعاد ناتج بنية (block) الدالة المُحدَّدة في المعامل <code>block</code>.
 == أمثلة ==
+'''مثالٌ على استخدام الدالة <code>run()‎</code> وفق الشكل الاول:'''
-=== استخدام الدالة <code>run()‎</code> وفق الشكل الاول ===
+تستدعي الشيفرة الآتية الدالة <code>run()‎</code> عبر الكائن <code>person</code> المُنشَأ من الصنف <code>Person</code> الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (name) والعمر(age) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة ثم سيُعاد ناتج بنية (block) الدالة إلى المتغير <code>a</code>:<syntaxhighlight lang="kotlin">
-تستدعي الشيفرة الآتية الدالة <code>run()‎</code> عبر الكائن <code>person</code> المُنشَأ من الصنف <code>Person</code> الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (<code>name</code>) والعمر(<code>age</code>) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة ثم سيُعاد ناتج بنية (block) الدالة إلى المتغير <code>a</code>:<syntaxhighlight lang="kotlin">
+class Person {
-fun main(args: Array<String>) {
+    var name = "أحمد"
-   val person = Person()
+    var age = 52
-   val a = person.run {
-       name = "bob"
-       age = 19
-       name + " " + age
-}
-       println(a) // bob 19
 }
-class Person {
+fun main(args: Array<String>) {
-   var name = "kim"
+    val person = Person()
-   var age = 52
+    val a = person.run {
+        name = "ناصر"
+        age = 19
+        name + " " + age
+    }
+    println(a) // ناصر 19
 }
-</syntaxhighlight>
+</syntaxhighlight>'''مثالٌ على استخدام الدالة <code>run()‎</code> وفق الشكل الثاني:'''
-=== استخدام الدالة <code>run()‎</code> وفق الشكل الثاني ===
+تستخدم الشيفرة الآتية الدالة <code>run()</code>‎ لتنفيذ بنية (block) برمجية تُعرّف متغيرين باسم <code>name</code> و <code>age</code> ثم تطبع قيمتيهما:<syntaxhighlight lang="kotlin">
-استخدام الدالة <code>run()</code>‎ لتنفيذ بنية (block) برمجية تُعرّف متغيرين <code>name</code> و <code>age</code> ثم تطبع قيمتهما:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-   run ({
+    run {
-       val name = "ryo"
+        val name = "أحمد"
-       val age = 14
+        val age = 14
-       print (name + " " + age)  // ryo 14
+        print(message = name + " " + age) // أحمد 14
-   })
+    }
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/apply|()apply]]</code>: تستدعي بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كمستقبِلٍ (receiver) لها وتُعيد قيمة <code>this</code>.
+* الدالة <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 Functions]]
+[[تصنيف:Kotlin Function]]