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