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

مراجعة 05:31، 8 سبتمبر 2018

تعيد الدالة takeIf()‎ الكائن (object) الذي استُدعيت عبره إن كان ذلك الكائن يحقق شرطًا معيّنًا، أو تعيد القيمة null بخلاف ذلك.

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

inline fun <T> T.takeIf(predicate: (T) -> Boolean): T?

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

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

الكائن الذي استُدعيت الدالة عبره إن كان ذلك الكائن يحقق شرطًا معيّنًا، أو تُعيد القيمة null بخلاف ذلك.

أمثلة

تستدعي الشيفرة الآتية الدالة takeIf()‎ عبر الكائن person المُنشَأ من الصنف Person الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (name) والعمر (age) بهدف اختباره، فإن كانت الخاصية name مساويةً للقيمة "yaser" فستعيد الدالة الكائن person نفسه، وإلا فستعيد القيمة null:

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

fun main(args: Array<String>) {
   // الحالة الأولى
   val person = Person()
   val x= person.takeIf {person.name == "yaser"}
   println(x?.name)   // yaser   

   // الحالة الثانية
   val person2 = Person()
   person2.name= "karim"
   val y= person2.takeIf {person2.name == "yaser"}  
   println(y)   // null
}

انظر أيضًا

الدالة ()takeUnless: تُعيد الكائن الذي استُدعيت عبره إن لم يحقق ذلك الكائن شرطًا معيّنًا، أو تعيد القيمة null بخلاف ذلك.

مصادر

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

@@ سطر 11: / سطر 11: @@
 == أمثلة ==
-=== استخدام الدالة <code>takeIf()‎</code> مع الكائنات ===
 تستدعي الشيفرة الآتية الدالة <code>takeIf()‎</code> عبر الكائن <code>person</code> المُنشَأ من الصنف <code>Person</code> الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (<code>name</code>) والعمر (<code>age</code>) بهدف اختباره، فإن كانت الخاصية <code>name</code> مساويةً للقيمة <code>"yaser"</code> فستعيد الدالة الكائن <code>person</code> نفسه، وإلا فستعيد القيمة <code>null</code>:<syntaxhighlight lang="kotlin">
 class Person {