الفرق بين المراجعتين ل"Kotlin/also"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق.)
ط
 
(4 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 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>.
 
تستدعي الدالة <code>also()‎</code> بُنية (block) الدالة المُحدَّدة مع جعل قيمة <code>this</code> كوسيط (argument) وتُعيد قيمة <code>this</code>.
  
سطر 7: سطر 7:
  
 
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
 
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
 +
 +
== المعاملات ==
 +
 +
=== <code>block</code> ===
 +
الكتلة البرمجية المراد استدعاؤها وتنفيذها.
  
 
== القيم المعادة ==
 
== القيم المعادة ==
سطر 14: سطر 19:
  
 
=== استخدام الدالة <code>also()‎</code> مع الكائنات لتعديل خاصياتها (properties) ===
 
=== استخدام الدالة <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>) {
 
fun main(args: Array<String>) {
  val string = "abc"
+
    val string = "abc"
  
  val result = string.also {
+
    val result = string.also {
 
         // println(this)
 
         // println(this)
         println(it) // => a
+
         println(it) // => abc
 
         5
 
         5
 
     }
 
     }
سطر 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.
  
 
== مصادر ==
 
== مصادر ==

المراجعة الحالية بتاريخ 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.

مصادر