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

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

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

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

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

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

المعاملات

`predicate`

دالةٌ تطبق على كل كائن من الكائنات المعطاة وتعيد قيمة منطقية مقابلة لكلٍّ منها.

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

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

أمثلة

تستدعي الشيفرة الآتية الدالة takeUnless()‎ عبر الكائن 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.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.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة takeUnless()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎takeUnless()‎</code> في Kotlin}}</noinclude>
-يعيد التابع takeUnless()‎ الكائن الذي استُدعي عبره إن لم يكن ذلك الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة null خلاف ذلك.
+تعيد الدالة <code>takeUnless()‎</code> الكائن (object) الذي استُدعي معها إن '''لم''' يكن هذا الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة <code>null</code> بخلاف ذلك.
 == البنية العامة ==
+<syntaxhighlight lang="kotlin">
 inline fun <T> T.takeUnless(predicate: (T) -> Boolean): T?
+</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
-يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+== المعاملات ==
+=== <code>predicate</code> ===
+دالةٌ تطبق على كل كائن من الكائنات المعطاة وتعيد قيمة منطقية مقابلة لكلٍّ منها.
 == القيم المعادة ==
-يعيد الكائن الذي استُدعي عبره إن لم يكن ذلك الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة null خلاف ذلك.
+تعيد الكائن الذي استُدعيت عبره الدالة إن لم يكن هذا الكائن يحقق شرطًا معيّنًا، أو تعيد القيمة <code>null</code> بخلاف ذلك.
 == أمثلة ==
+تستدعي الشيفرة الآتية الدالة <code>takeUnless()‎</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">
-=== استخدام التابع 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
 }
+</syntaxhighlight>
 == انظر أيضًا ==
-* ()takeIf: تُعيد الكائن الذي استُدعيت عبره إن كان ذلك الكائن يحقق شرطًا معيّنًا، أو تعيد القيمة null خلاف ذلك.
+* الدالة <code>[[Kotlin/takeIf|()takeIf]]</code>: تُعيد الكائن الذي استُدعيت عبره إن كان هذا الكائن يحقق شرطًا معيّنًا، أو تعيد القيمة <code>null</code> بخلاف ذلك.
 == مصادر ==
-* التابع takeUnless()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/take-unless.html صفحة الدالة takeUnless()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]