الفرق بين المراجعتين لصفحة: «Kotlin/takeUnless»
< Kotlin
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة takeUnless() في لغة Kotlin}}</noinclude> يعيد التابع takeUnless() الكائن الذي استُدعي عب...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة takeUnless() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة takeUnless() في لغة Kotlin}}</noinclude> | ||
تعيد الدالة <code>takeUnless()</code> الكائن الذي استُدعي عبره إن لم يكن ذلك الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة <code>null</code> خلاف ذلك. | |||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | |||
inline fun <T> T.takeUnless(predicate: (T) -> Boolean): T? | inline fun <T> T.takeUnless(predicate: (T) -> Boolean): T? | ||
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | |||
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع [[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | |||
== القيم المعادة == | == القيم المعادة == | ||
يعيد الكائن الذي استُدعي عبره إن لم يكن ذلك الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة null خلاف ذلك. | يعيد الكائن الذي استُدعي عبره إن لم يكن ذلك الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة <code>null</code> خلاف ذلك. | ||
== أمثلة == | == أمثلة == | ||
=== استخدام | === استخدام الدالة <code>takeUnless()</code> مع الكائنات (objects) === | ||
تستدعي الشيفرة الآتية | تستدعي الشيفرة الآتية الدالة <code>takeUnless()</code> عبر الكائن <code>person</code> المُنشَأ من الصنف <code>Person</code> الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (<code>name</code>) والعمر (<code>age</code>)، فإن كانت الخاصية <code>name</code> لا تساوي القيمة <code>"bob"</code> فسيعيد الكائنَ <code>person</code> نفسه وإلا فسيعيد القيمة <code>null</code>:<syntaxhighlight lang="kotlin"> | ||
class Person { | class Person { | ||
var name = "yaser" | var name = "yaser" | ||
var age = 52 | var age = 52 | ||
} | } | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
// الحالة الأولى | // الحالة الأولى | ||
val person = Person() | val person = Person() | ||
val x= person.takeUnless {person.name == "yaser"} | val x= person.takeUnless {person.name == "yaser"} | ||
println(x) // null | println(x) // null | ||
// الحالة الثانية | // الحالة الثانية | ||
val person2 = Person() | val person2 = Person() | ||
person2.name= "karim" | person2.name= "karim" | ||
val y= person2.takeUnless {person2.name == "yaser"} | val y= person2.takeUnless {person2.name == "yaser"} | ||
println(y?.name) // karim | println(y?.name) // karim | ||
} | } | ||
</syntaxhighlight> | |||
== انظر أيضًا == | == انظر أيضًا == | ||
* ()takeIf: تُعيد الكائن الذي استُدعيت عبره إن كان ذلك الكائن يحقق شرطًا معيّنًا، أو تعيد القيمة null خلاف ذلك. | * <code>[[Kotlin/takeIf|()takeIf]]</code>: تُعيد الكائن الذي استُدعيت عبره إن كان ذلك الكائن يحقق شرطًا معيّنًا، أو تعيد القيمة null خلاف ذلك. | ||
== مصادر == | == مصادر == | ||
* | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/take-unless.html الدالة takeUnless() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 19:01، 9 مايو 2018
تعيد الدالة 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 خلاف ذلك.