Kotlin/let

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

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

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

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

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

المعاملات

block

الكتلة البرمجية المراد استدعاؤها وتنفيذها.

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

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

أمثلة

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

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

fun main(args: Array<String>) {
   val person = Person()
   val num = person.let {
       it.name = "Nasser"  
       it.age = 19
       println(it.name) // Nasser
       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.