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

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

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

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

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

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

المعاملات

`block`

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

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

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

أمثلة

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

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

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

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

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة also()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎also()</code>‎ في 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)]].
+</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>block</code> ===
+الكتلة البرمجية المراد استدعاؤها وتنفيذها.
 == القيم المعادة ==
@@ سطر 13: / سطر 19: @@
 === استخدام الدالة <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>  مع تمرير بنية الدالة المحدَّدة لتطبع قيمة السلسة النصية؛ لاحظ أن كتلة الدالة تنتهي بالعدد 5، ومع ذلك فالدالة <code>also()‎</code>  تعيد السلسلة النصية التي استُدعيت عبرها (<code>this</code>) وليس القيمة الأخيرة في بنية الدالة (5):<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) // => abc
+    }
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* [[Kotlin/this expressions|تعابير this في لغة Kotlin.]]
+* الدالة <code>[[Kotlin/let|()let]]</code>: تنفِّذ مجموعة من التعليمات (ضمن block)، إذ تُمرَّر قيمة <code>this</code> كمتحولٍ وسيطٍ (argument) ثم تُعيد ناتج هذا التنفيذ.
-* الدالة <code>[[kotlin/let|()let]]</code>: تنفِّذ مجموعة من التعليمات (ضمن block) بحيث تُمرَّر قيمة <code>this</code> كمتحولٍ وسيطٍ (argument) ثم تُعيد ناتج هذا التنفيذ.
+* الدالة <code>[[Kotlin/run|()run]]</code>: تنفِّذ مجموعة من التعليمات المُحدَّدة (ضمن block) وتُعيد قيمة ناتجها.
-* الدالة <code>[[kotlin/also|also()‎]]</code>: تنفِّذ مجموعة من التعليمات (ضمن block) على الكائن الذي استُدعيت عبره بحيث تُمرَّر قيمة this كمتحول وسيط (argument) ثم تُعيد الكائن نفسه.
+* تعابير [[Kotlin/this expressions|this]] في Kotlin.
-* الدالة <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]]