الفرق بين المراجعتين لصفحة: «Kotlin/let»

المراجعة الحالية بتاريخ 06:29، 8 سبتمبر 2018

تستدعي الدالة 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.

@@ سطر 8: / سطر 8: @@
 inline fun <T, R> T.let(block: (T) -> R): R
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+== المعاملات ==
+=== <code>block</code> ===
+الكتلة البرمجية المراد استدعاؤها وتنفيذها.
 == القيم المعادة ==
-تعيد ناتج تنفيذ بنية (block) الدالة المُحدَّدة.
+يعاد ناتج تنفيذ بنية (block) الدالة المُحدَّدة في المعامل <code>block</code>.
 == أمثلة ==
-=== استخدام الدالة<code>let()</code> ‎ مع الكائنات (objects) ===
 تستدعي الشيفرة الآتية الدالة <code>let()‎</code> عبر الكائن <code>person</code> المُنشَأ من الصنف <code>Person</code> والذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (<code>name</code>) والعمر (<code>age</code>) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة عبر استدعائهما من الاسم الضمني (implicit name)‏ <code>[[Kotlin/lambdas#it: .D8.A7.D9.84.D8.A7.D8.B3.D9.85 .D8.A7.D9.84.D8.B6.D9.85.D9.86.D9.8A .28implicit name.29 .D9.84.D9.84.D9.85.D8.AA.D8.AD.D9.88.D9.84 .D8.A7.D9.84.D9.88.D8.AD.D9.8A.D8.AF|it]]</code>، ثم سيُعاد ناتج تنفيذ هذه  البنية (block) إلى المتغيّر <code>num</code>، تذكر أنّ الدالة <code>let</code> تعيد قيمة آخر تعليمة في البنية، لذلك لا داعي في هذه الحالة للطباعة أو الإسناد للسلسلة النصيّة <code>"OK"</code>:<syntaxhighlight lang="kotlin">
 class Person {