الفرق بين المراجعتين لصفحة: «Kotlin/takeUnless»
< Kotlin
لا ملخص تعديل |
مراجعة |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة takeUnless() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة takeUnless() في لغة Kotlin}}</noinclude> | ||
تعيد الدالة <code>takeUnless()</code> الكائن الذي | تعيد الدالة <code>takeUnless()</code> الكائن (object) الذي استُدعيت عبره إن '''لم''' يكن هذا الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة <code>null</code> بخلاف ذلك. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 8: | سطر 8: | ||
== القيم المعادة == | == القيم المعادة == | ||
يعيد الكائن الذي | يعيد الكائن الذي استُدعيت عبره الدالة إن لم يكن هذا الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة <code>null</code> بخلاف ذلك. | ||
== أمثلة == | == أمثلة == | ||
=== استخدام الدالة <code>takeUnless()</code> مع الكائنات (objects) === | === استخدام الدالة <code>takeUnless()</code> مع الكائنات (objects) === | ||
تستدعي الشيفرة الآتية الدالة <code>takeUnless()</code> عبر الكائن <code>person</code> المُنشَأ من الصنف <code>Person</code> الذي يحتوي على بيانات أوليّة لكلٍ من خاصيتيّ الاسم (<code>name</code>) والعمر (<code>age</code>)، فإن كانت الخاصية <code>name</code> لا تساوي القيمة <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"> | ||
class Person { | class Person { | ||
var name = "yaser" | var name = "yaser" | ||
| سطر 34: | سطر 34: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* <code>[[Kotlin/takeIf|()takeIf]]</code>: تُعيد الكائن الذي استُدعيت عبره إن كان | * الدالة <code>[[Kotlin/takeIf|()takeIf]]</code>: تُعيد الكائن الذي استُدعيت عبره إن كان هذا الكائن يحقق شرطًا معيّنًا، أو تعيد القيمة <code>null</code> بخلاف ذلك. | ||
== مصادر == | == مصادر == | ||
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/take-unless.html الدالة takeUnless() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | * صفحة [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/take-unless.html الدالة takeUnless() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
مراجعة 14:37، 26 مايو 2018
تعيد الدالة takeUnless() الكائن (object) الذي استُدعيت عبره إن لم يكن هذا الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة null بخلاف ذلك.
البنية العامة
inline fun <T> T.takeUnless(predicate: (T) -> Boolean): T?
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
يعيد الكائن الذي استُدعيت عبره الدالة إن لم يكن هذا الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة null بخلاف ذلك.
أمثلة
استخدام الدالة takeUnless() مع الكائنات (objects)
تستدعي الشيفرة الآتية الدالة 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بخلاف ذلك.