الدالة apply()‎ في لغة Kotlin

البنية العامة

inline fun <T> T.apply(block: T.() -> Unit): T

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

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

تعيد الكائن الذي استدعيت عبره وذلك بعد التعديل عليه.

أمثلة

استخدام الدالة apply()‎ مع الكائنات لتعديل خاصيّاتها (properties)

تستدعي الشيفرة الآتية الدالة apply()‎ عبر الكائن person المُنشَأ من الصنف Person الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (name) والعمر (age) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة كما يلي:

fun main(args: Array<String>) {
   val person = Person().apply {
   name = "Ahmed"
   age = 22
   // يمكنك إضافة تعليمات أخرى
}

   println("${person.name}")  // Ahmed
   println("${person.age}") // 22

}

class Person {
   var name = "samar"
   var age = 52
}

انظر أيضًا

• تعابير this في لغة Kotlin.
• الدالة ()let: تنفِّذ مجموعة من التعليمات (ضمن block) بحيث تُمرَّر قيمة this كمتحولٍ وسيطٍ (argument) ثم تُعيد ناتج هذا التنفيذ.
• الدالة ()also: تنفِّذ مجموعة من التعليمات (ضمن block) على الكائن الذي استُدعيت عبره بحيث تُمرَّر قيمة this كمتحول وسيط (argument) ثم تُعيد الكائن نفسه.
• الدالة ()run: تنفذ مجموعة من التعليمات المُحدَّدة (ضمن block) وتُعيد قيمة ناتجها.

مصادر

• الدالة apply()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.