الفرق بين المراجعتين لصفحة: «Kotlin/apply»
< Kotlin
لا ملخص تعديل |
مراجعة أولى |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة apply() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة apply() في لغة Kotlin}}</noinclude> | ||
تستدعي الدالة <code>apply()</code> | تستدعي الدالة <code>apply()</code> بُنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كمستقبِلٍ (receiver) لها وتُعيد قيمة <code>this</code>. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 8: | سطر 8: | ||
== القيم المعادة == | == القيم المعادة == | ||
تعيد الكائن الذي استدعيت عبره | تعيد الكائن الذي استدعيت عبره بعد التعديل عليه. | ||
== أمثلة == | == أمثلة == | ||
=== استخدام الدالة <code>apply()</code> مع الكائنات لتعديل | === استخدام الدالة <code>apply()</code> مع الكائنات لتعديل خاصياتها (properties) === | ||
تستدعي الشيفرة الآتية الدالة <code>apply()</code> عبر الكائن <code>person</code> المُنشَأ من الصنف <code>Person</code> الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (<code>name</code>) والعمر (<code>age</code>) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية | تستدعي الشيفرة الآتية الدالة <code>apply()</code> عبر الكائن <code>person</code> المُنشَأ من الصنف <code>Person</code> الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (<code>name</code>) والعمر (<code>age</code>) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة، أي ستصبح القيم <code>Ahmad</code> و <code>22</code> بدلًا من <code>Samar</code> و <code>52</code> لكلٍّ من خاصيتيّ <code>name</code> و <code>age</code> على الترتيب لتصبح الشيفرة كما يلي:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val person = Person().apply { | val person = Person().apply { | ||
name = " | name = "Ahmad" | ||
age = 22 | age = 22 | ||
// يمكنك إضافة تعليمات أخرى | // يمكنك إضافة تعليمات أخرى | ||
} | } | ||
println("${person.name}") // | println("${person.name}") // Ahmad | ||
println("${person.age}") // 22 | println("${person.age}") // 22 | ||
| سطر 27: | سطر 27: | ||
class Person { | class Person { | ||
var name = " | var name = "Samar" | ||
var age = 52 | var age = 52 | ||
} | } | ||
| سطر 36: | سطر 36: | ||
* الدالة <code>[[kotlin/let|()let]]</code>: تنفِّذ مجموعة من التعليمات (ضمن block) بحيث تُمرَّر قيمة <code>this</code> كمتحولٍ وسيطٍ (argument) ثم تُعيد ناتج هذا التنفيذ. | * الدالة <code>[[kotlin/let|()let]]</code>: تنفِّذ مجموعة من التعليمات (ضمن block) بحيث تُمرَّر قيمة <code>this</code> كمتحولٍ وسيطٍ (argument) ثم تُعيد ناتج هذا التنفيذ. | ||
* الدالة <code>()[[kotlin/also|also]]</code>: تنفِّذ مجموعة من التعليمات (ضمن block) على الكائن الذي استُدعيت عبره بحيث تُمرَّر قيمة this كمتحول وسيط (argument) ثم تُعيد الكائن نفسه. | * الدالة <code>()[[kotlin/also|also]]</code>: تنفِّذ مجموعة من التعليمات (ضمن block) على الكائن الذي استُدعيت عبره بحيث تُمرَّر قيمة this كمتحول وسيط (argument) ثم تُعيد الكائن نفسه. | ||
* الدالة <code>[[kotlin/run|()run]]</code>: | * الدالة <code>[[kotlin/run|()run]]</code>: تنفِّذ مجموعة من التعليمات المُحدَّدة (ضمن block) وتُعيد قيمة ناتجها. | ||
== مصادر == | == مصادر == | ||
مراجعة 02:49، 21 مايو 2018
تستدعي الدالة apply() بُنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كمستقبِلٍ (receiver) لها وتُعيد قيمة this.
البنية العامة
inline fun <T> T.apply(block: T.() -> Unit): T
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
تعيد الكائن الذي استدعيت عبره بعد التعديل عليه.
أمثلة
استخدام الدالة apply() مع الكائنات لتعديل خاصياتها (properties)
تستدعي الشيفرة الآتية الدالة apply() عبر الكائن person المُنشَأ من الصنف Person الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (name) والعمر (age) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة، أي ستصبح القيم Ahmad و 22 بدلًا من Samar و 52 لكلٍّ من خاصيتيّ name و age على الترتيب لتصبح الشيفرة كما يلي:
fun main(args: Array<String>) {
val person = Person().apply {
name = "Ahmad"
age = 22
// يمكنك إضافة تعليمات أخرى
}
println("${person.name}") // Ahmad
println("${person.age}") // 22
}
class Person {
var name = "Samar"
var age = 52
}
انظر أيضًا
- تعابير this في لغة Kotlin.
- الدالة
()let: تنفِّذ مجموعة من التعليمات (ضمن block) بحيث تُمرَّر قيمةthisكمتحولٍ وسيطٍ (argument) ثم تُعيد ناتج هذا التنفيذ. - الدالة
()also: تنفِّذ مجموعة من التعليمات (ضمن block) على الكائن الذي استُدعيت عبره بحيث تُمرَّر قيمة this كمتحول وسيط (argument) ثم تُعيد الكائن نفسه. - الدالة
()run: تنفِّذ مجموعة من التعليمات المُحدَّدة (ضمن block) وتُعيد قيمة ناتجها.