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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
 
(10 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة apply()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎apply()‎</code> في Kotlin}}</noinclude>
تستدعي الدالة <code>apply()‎</code> بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كمستقبِلٍ (receiver) لها وتُعيد قيمة <code>this</code>.
+
تستدعي الدالة <code>apply()‎</code> بُنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كمستقبِلٍ (receiver) لها وتُعيد قيمة <code>this</code>.
  
 
== البنية العامة ==
 
== البنية العامة ==
سطر 6: سطر 6:
 
inline fun <T> T.apply(block: T.() -> Unit): T
 
inline fun <T> T.apply(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> ===
 +
الكتلة البرمجية المراد استدعاؤها وتنفيذها.
  
 
== القيم المعادة ==
 
== القيم المعادة ==
تعيد الكائن الذي استدعيت عبره وذلك بعد التعديل عليه.
+
يعاد الكائن المعطى بعد تعديله.
  
 
== أمثلة ==
 
== أمثلة ==
 
+
تستدعي الشيفرة الآتية الدالة <code>apply()‎</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>apply()‎</code> مع الكائنات لتعديل خاصيّاتها (properties) ===
 
تستدعي الشيفرة الآتية الدالة <code>apply()‎</code> عبر الكائن <code>person</code> المُنشَأ من الصنف <code>Person</code> الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (<code>name</code>) والعمر (<code>age</code>) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة كما يلي:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
 
   val person = Person().apply {
 
   val person = Person().apply {
   name = "Ahmed"
+
   name = "Ahmad"
 
   age = 22
 
   age = 22
 
   // يمكنك إضافة تعليمات أخرى
 
   // يمكنك إضافة تعليمات أخرى
 
}
 
}
  
   println("${person.name}")  // Ahmed
+
   println("${person.name}")  // Ahmad
 
   println("${person.age}") // 22
 
   println("${person.age}") // 22
  
سطر 27: سطر 30:
  
 
class Person {
 
class Person {
   var name = "samar"
+
   var name = "Samar"
 
   var age = 52
 
   var age = 52
 
}
 
}
سطر 33: سطر 36:
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* [[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/also|also()‎]]</code>: تنفِّذ مجموعة من التعليمات (ضمن block) على الكائن الذي استُدعيت عبره بحيث تُمرَّر قيمة this كمتحول وسيط (argument) ثم تُعيد الكائن نفسه.
* الدالة <code>()[[kotlin/also|also]]</code>: تنفِّذ مجموعة من التعليمات (ضمن block) على الكائن الذي استُدعيت عبره بحيث تُمرَّر قيمة this كمتحول وسيط (argument) ثم تُعيد الكائن نفسه.
+
* الدالة <code>[[Kotlin/run|()run]]</code>: تنفِّذ مجموعة من التعليمات المُحدَّدة (ضمن block) وتُعيد قيمة ناتجها.
* الدالة <code>[[kotlin/run|()run]]</code>: تنفذ مجموعة من التعليمات المُحدَّدة (ضمن block) وتُعيد قيمة ناتجها.
+
* تعابير [[Kotlin/this expressions|this]] في لغة Kotlin.
  
 
== مصادر ==
 
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/equals.html الدالة apply()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/apply.html صفحة الدالة apply()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
+
[[تصنيف:Kotlin Function]]

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

تستدعي الدالة apply()‎ بُنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كمستقبِلٍ (receiver) لها وتُعيد قيمة this.

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

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

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

المعاملات

block

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

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

يعاد الكائن المعطى بعد تعديله.

أمثلة

تستدعي الشيفرة الآتية الدالة apply()‎ عبر الكائن person المُنشَأ من الصنف Person الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (name) والعمر (age) مما سيؤدي لتعديلهما بحسب القيم المذكورة في بنية الدالة، أي ستصبح القيم Ahmad و 22 بدلًا من Samar و 52 لكلٍّ من خاصيتيّ name و age على الترتيب لتصبح الشيفرة كما يلي:

fun main(args: Array<String>) {
   val person = Person().apply {
   name = "Ahmad"
   age = 22
   // يمكنك إضافة تعليمات أخرى
}

   println("${person.name}")  // Ahmad
   println("${person.age}") // 22

}

class Person {
   var name = "Samar"
   var age = 52
}

انظر أيضًا

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

مصادر