Kotlin/let

تستدعي الدالة let()‎ بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كوسيط (argument) لها وتعيد ناتج التنفيذ.

عادة ما تُُستخدم let()‎لمنع الوصول إلى  المتغيرات في مجال الأسماء (namespace) إذ إنّ كل المتغيرات المعرَّفة داخلها لن تكون متاحةً خارج تلك البنية (block).

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

inline fun <T, R> T.let(block: (T) -> R): R

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

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

تعيد ناتج تنفيذ بنية (block) الدالة المُحدَّدة.

أمثلة

استخدام الدالةlet() ‎ مع الكائنات (objects)

تستدعي الشيفرة الآتية الدالة let()‎ عبر الكائن person المُنشَأ من الصنف Person والذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (name) والعمر (age) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة عبر استدعائهما من الاسم الضمني (implicit name)‏ it، ثم سيُعاد ناتج تنفيذ هذه  البنية (block) إلى المتغيّر num. تذكر أنّ الدالة let تعيد قيمة آخر تعليمة في البنية، لذلك لا داعي في هذه الحالة للطباعة أو الإسناد:

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

fun main(args: Array<String>) {
   val person = Person()
   val num = person.let {
       it.name = "Naser"  
       it.age = 19
       println(it.name) // bob
       println(it.age) // 19
       println()
       "OK"
}

   println("$num") // OK
}

لاحظ استخدام الاسم الضمني itالذي يمثل الوسيط الوحيد عندما يُستخدم داخل بنيات (blocks) الدوال التي تقبل وسيطًا واحدًا، راجع صفح الاسم الضمني it لمزيد من المعلومات.

انظر أيضًا

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

مصادر

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