الفرق بين المراجعتين لصفحة: «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> كوسيط (argument) وتُعيد قيمة <code>this</code>.
@@ سطر 7: / سطر 7: @@
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>block</code> ===
+الكتلة البرمجية المراد استدعاؤها وتنفيذها.
 == القيم المعادة ==
@@ سطر 14: / سطر 19: @@
 === استخدام الدالة <code>also()‎</code> مع الكائنات لتعديل خاصياتها (properties) ===
-تستدعي الشيفرة الآتية الدالة <code>also()‎</code> عبر [[kotlin/String|السلسلة النصية]] <code>string</code>  مع تمرير بنية الدالة المحدَّدة لتطبع قيمة السلسة النصية؛ لاحظ أن كتلة الدالة تنتهي بالعدد 5، ومع ذلك فالدالة <code>also()‎</code>  تعيد السلسلة النصية التي استُدعيت عبرها (<code>this</code>) وليس القيمة الأخيرة في بنية الدالة (5):<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 string = "abc"
+    val string = "abc"
-   val result = string.also {
+    val result = string.also {
          // println(this)
-         println(it) // => a
+         println(it) // => abc
      }
@@ سطر 27: / سطر 32: @@
 == انظر أيضًا ==
-* [[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/run|()run]]</code>: تنفِّذ مجموعة من التعليمات المُحدَّدة (ضمن block) وتُعيد قيمة ناتجها.
+* تعابير [[Kotlin/this expressions|this]] في Kotlin.
 == مصادر ==