الدالة apply()
في Kotlin
< Kotlin
اذهب إلى التنقل
اذهب إلى البحث
مراجعة 06:31، 8 سبتمبر 2018 بواسطة جميل-بيلوني (نقاش | مساهمات)
تستدعي الدالة apply()
بُنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this
كمستقبِلٍ (receiver) لها وتُعيد قيمة this
.
البنية العامة
inline fun <T> T.apply(block: T.() -> Unit): T
يُلاحَظ وجود الكلمة المفتاحية inline
للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
المعاملات
block
الكتلة البرمجية المراد استدعاؤها وتنفيذها.
القيم المعادة
يعاد الكائن المعطى بعد تعديله.
أمثلة
تستدعي الشيفرة الآتية الدالة 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
}
انظر أيضًا
- الدالة
()let
: تنفِّذ مجموعة من التعليمات (ضمن block) بحيث تُمرَّر قيمةthis
كمتحولٍ وسيطٍ (argument) ثم تُعيد ناتج هذا التنفيذ. - الدالة
also()
: تنفِّذ مجموعة من التعليمات (ضمن block) على الكائن الذي استُدعيت عبره بحيث تُمرَّر قيمة this كمتحول وسيط (argument) ثم تُعيد الكائن نفسه. - الدالة
()run
: تنفِّذ مجموعة من التعليمات المُحدَّدة (ضمن block) وتُعيد قيمة ناتجها. - تعابير this في لغة Kotlin.