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

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

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

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

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

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

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

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

أمثلة

استخدام الدالة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.