الفرق بين المراجعتين لصفحة: «Kotlin/run»
< Kotlin
لا ملخص تعديل |
مراجعة |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة run() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة run() في لغة Kotlin}}</noinclude> | ||
يمكن استخدام <code>run()</code> بطريقتين: | يمكن استخدام الدالة <code>run()</code> بطريقتين: | ||
* | * استدعاء بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كمستقبِلٍ (receiver) له وإعادة قيمة ناتج البنية. | ||
* | * استدعاء بنية (block) الدالة المُحدَّدة وإعادة ناتجها. | ||
== البنية العام == | == البنية العام == | ||
| سطر 23: | سطر 23: | ||
=== استخدام الدالة <code>run()</code> وفق الشكل الاول === | === استخدام الدالة <code>run()</code> وفق الشكل الاول === | ||
تستدعي الشيفرة الآتية الدالة <code>run()</code> عبر الكائن <code>person</code> المُنشَأ من الصنف <code>Person</code> الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (<code>name</code>) والعمر(<code>age</code>) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة ثم سيُعاد ناتج بنية (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 { | |||
var name = "Ahmad" | |||
var age = 52 | |||
} | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val person = Person() | val person = Person() | ||
val a = person.run { | val a = person.run { | ||
name = " | name = "Nasser" | ||
age = 19 | age = 19 | ||
name + " " + age | name + " " + age | ||
} | } | ||
println(a) // | println(a) // Nasser 19 | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== استخدام الدالة <code>run()</code> وفق الشكل الثاني === | === استخدام الدالة <code>run()</code> وفق الشكل الثاني === | ||
تستخدم الشيفرة الآتية الدالة <code>run()</code> لتنفيذ بنية (block) برمجية تُعرّف متغيرين باسم <code>name</code> و <code>age</code> ثم تطبع قيمتيهما:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
run ({ | run ({ | ||
val name = " | val name = "Nasser" | ||
val age = 14 | val age = 14 | ||
print (name + " " + age) // | print (name + " " + age) // Nasser 14 | ||
}) | }) | ||
} | } | ||
| سطر 52: | سطر 53: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* <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.] | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/run.html صفحة الدالة run() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
مراجعة 03:03، 23 مايو 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) الدالة المُحدَّدة.
أمثلة
استخدام الدالة run() وفق الشكل الاول
تستدعي الشيفرة الآتية الدالة run() عبر الكائن person المُنشَأ من الصنف Person الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (name) والعمر(age) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة ثم سيُعاد ناتج بنية (block) الدالة إلى المتغير a:
class Person {
var name = "Ahmad"
var age = 52
}
fun main(args: Array<String>) {
val person = Person()
val a = person.run {
name = "Nasser"
age = 19
name + " " + age
}
println(a) // Nasser 19
}
استخدام الدالة run() وفق الشكل الثاني
تستخدم الشيفرة الآتية الدالة run() لتنفيذ بنية (block) برمجية تُعرّف متغيرين باسم name و age ثم تطبع قيمتيهما:
fun main(args: Array<String>) {
run ({
val name = "Nasser"
val age = 14
print (name + " " + age) // Nasser 14
})
}
انظر أيضًا
- الدالة
()apply: تستدعي بنية (block) الدالة المُحدَّدة وذلك بجعل قيمةthisكمستقبِلٍ (receiver) لها وتُعيد قيمةthis.