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