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

مراجعة 13:33، 27 يونيو 2018

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

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

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

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

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

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

أمثلة

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

تستدعي الشيفرة الآتية الدالة also()‎ عبر السلسلة النصية string مع تمرير بنية الدالة المحددة، لتطبع قيمة السلسة النصية، لاحظ أن كتلة الدالة تنتهي بالعدد 5، مع ذلك فالدالة also()‎ تعيد السلسلة النصية التي استُدعيت عبرها (this) وليس القيمة الأخيرة في بنية الدالة (5):

fun main(args: Array<String>) {
   val string = "abc"

   val result = string.also {
        // println(this)
        println(it) // => a
        5
    }
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة also()‎ في لغة Kotlin}}</noinclude>
-تستدعي الدالة <code>also()‎</code> بُنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كمستقبِلٍ (receiver) لها وتُعيد قيمة <code>this</code>.
+تستدعي الدالة <code>also()‎</code> بُنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كوسيط (argument) وتُعيد قيمة <code>this</code>.
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
-inline fun <T> T.apply(block: T.() -> Unit): T
+inline fun <T> T.also(block: (T) -> Unit): T
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
@@ سطر 13: / سطر 14: @@
 === استخدام الدالة <code>also()‎</code> مع الكائنات لتعديل خاصياتها (properties) ===
-تستدعي الشيفرة الآتية الدالة <code>also()‎</code> عبر الكائن <code>person</code> المُنشَأ من الصنف <code>Person</code> الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (<code>name</code>) والعمر (<code>age</code>) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة، أي ستصبح القيم <code>Ahmad</code> و <code>22</code>  بدلًا من <code>Samar</code> و <code>52</code> لكلٍّ من خاصيتيّ <code>name</code> و <code>age</code> على الترتيب لتصبح الشيفرة كما يلي:<syntaxhighlight lang="kotlin">
+تستدعي الشيفرة الآتية الدالة <code>also()‎</code> عبر [[kotlin/String|السلسلة النصية]] <code>string</code>  مع تمرير بنية الدالة المحددة، لتطبع قيمة السلسة النصية، لاحظ أن كتلة الدالة تنتهي بالعدد <code>5،</code> مع ذلك فالدالة <code>also()‎</code>  تعيد السلسلة النصية التي استُدعيت عبرها (<code>this</code>) وليس القيمة الأخيرة في بنية الدالة (<code>5</code>):<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-   val person = Person().apply {
+   val string = "abc"
-   name = "Ahmad"
-   age = 22
-   // يمكنك إضافة تعليمات أخرى
-}
-   println("${person.name}")  // Ahmad
-   println("${person.age}") // 22
-}
-class Person {
+   val result = string.also {
-   var name = "Samar"
+        // println(this)
-   var age = 52
+        println(it) // => a
+    }
 }
 </syntaxhighlight>
@@ سطر 35: / سطر 29: @@
 * [[Kotlin/this expressions|تعابير this في لغة Kotlin.]]
 * الدالة <code>[[kotlin/let|()let]]</code>: تنفِّذ مجموعة من التعليمات (ضمن block) بحيث تُمرَّر قيمة <code>this</code> كمتحولٍ وسيطٍ (argument) ثم تُعيد ناتج هذا التنفيذ.
-* الدالة <code>[[kotlin/also|also()‎]]</code>: تنفِّذ مجموعة من التعليمات (ضمن block) على الكائن الذي استُدعيت عبره بحيث تُمرَّر قيمة this كمتحول وسيط (argument) ثم تُعيد الكائن نفسه.
 * الدالة <code>[[kotlin/run|()run]]</code>: تنفِّذ مجموعة من التعليمات المُحدَّدة (ضمن block) وتُعيد قيمة ناتجها.
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/equals.html صفحة الدالة also()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/also.html صفحة الدالة also()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]