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

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

تبحث الدالة find()‎ على عنصر محدَّد ضمن عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد أول ظهور له.

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

inline fun <T> Array<out T>.find(
    predicate: (T) -> Boolean
): T? 
inline fun ByteArray.find(
    predicate: (Byte) -> Boolean
): Byte? 
inline fun ShortArray.find(
    predicate: (Short) -> Boolean
): Short? 
inline fun IntArray.find(predicate: (Int) -> Boolean): Int? (source)
inline fun LongArray.find(
    predicate: (Long) -> Boolean
): Long? 
inline fun FloatArray.find(
    predicate: (Float) -> Boolean
): Float? 
inline fun DoubleArray.find(
    predicate: (Double) -> Boolean
): Double? 
inline fun BooleanArray.find(
    predicate: (Boolean) -> Boolean
): Boolean? 
inline fun CharArray.find(
    predicate: (Char) -> Boolean
): Char? 
inline fun <T> Iterable<T>.find(
    predicate: (T) -> Boolean
): T?

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

المعاملات

`predicate`

دالةٌ تمثل الشرط المراد تطبيقه على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة. يمرر إلى هذه الدالة قيمة العنصر وتعيد قيمةً منطقيةً.

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

يعاد أول ظهور للعنصر المبحوث عنه ضمن عناصر المصفوفة أو المجموعة المعطاة والذي يحقق الشرط المنطقي predicate المعطى أيضًا، أو القيمة null إن لم يُعثر على أي عنصر يحقق ذلك الشرط.

أمثلة

استعمال الدالة ()find للبحث عن أول عنصر محقق لشرط معين ضمن مصفوفة:

fun main(args: Array<String>) {
    val array = arrayOf(9, 2, 3, 0, 5, 1)
    val predicate1: (Int) -> Boolean = { it < 3 }
    val predicate2: (Int) -> Boolean = { it == 6 }

    println(array.find(predicate1)) // 2
    println(array.find(predicate2)) // null
}

انظر أيضًا

الدالة findLast()‎: تبحث على عنصر محدَّد ضمن عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد آخر ظهور له.
الدالة firstOrNull()‎: تجلب أول عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
الدالة filter()‎: ترشِّح عناصر المصفوفة أو المجموعة أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها.

مصادر

صفحة الدالة find()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 33: / سطر 33: @@
 </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>predicate</code> ===
+دالةٌ تمثل الشرط المراد تطبيقه على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة. يمرر إلى هذه الدالة قيمة العنصر وتعيد قيمةً منطقيةً.
 ==القيم المعادة==
 يعاد أول ظهور للعنصر المبحوث عنه ضمن عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة والذي يحقق الشرط المنطقي <code>predicate</code> المعطى أيضًا، أو القيمة <code>null</code> إن لم يُعثر على أي عنصر يحقق ذلك الشرط.
 ==أمثلة==
-===استخدام الدالة <code>()find</code> مع المصفوفات: حالة العثور على عنصر===
+<nowiki/>استعمال الدالة <code>()find</code> للبحث عن أول عنصر محقق لشرط معين ضمن مصفوفة:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code>، ثم تُعرّف الدالة المنطقية <code>()predicate</code> التي تحدِّد ما إذا كان العدد المُمرّر إليها أصغر من 3 ، ثم تستخدم الدالة <code>()find</code> للبحث عن أول عنصر يحقق هذا الشرط:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val array = arrayOf(9, 2, 3, 0, 5, 1)
-     val predicate  : (Int) -> Boolean = { it < 3 }
+     val predicate1: (Int) -> Boolean = { it < 3 }
+     val predicate2: (Int) -> Boolean = { it == 6 }
-    println(array.find(predicate)) // 2
-}
-</syntaxhighlight>
-===استخدام الدالة <code>()find</code> مع المصفوفات: حالة عدم العثور على أي عنصر===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()find</code> للبحث عن أول عنصر يساوي القيمة 6. ولمّا كانت كل عناصر <code>array</code> لا تحقق هذا الشرط، فستُعاد القيمة <code>null</code>:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-    val array = arrayOf(9, 2, 3, 2, 5, 1)
-     val predicate: (Int) -> Boolean = { it == 6 }
-     println(array.find(predicate)) // null
+     println(array.find(predicate1)) // 2
+    println(array.find(predicate2)) // null
 }
 </syntaxhighlight>
@@ سطر 61: / سطر 59: @@
 *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/find.html صفحة الدالة find()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]