الدالة takeUnless()‎ في لغة Kotlin

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

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

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

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

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

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

أمثلة

استخدام التابع takeUnless()‎ مع الكائنات (objects)

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

class Person {

   var name = "yaser"

   var age = 52

}

fun main(args: Array<String>) {

   // الحالة الأولى

   val person = Person()

   val x= person.takeUnless {person.name == "yaser"}

   println(x)   // null   

   // الحالة الثانية

   val person2 = Person()

   person2.name= "karim"

   val y= person2.takeUnless {person2.name == "yaser"}  

   println(y?.name)   // karim

}

انظر أيضًا

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

مصادر

• التابع takeUnless()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.