الدالة indexOfFirst() في Kotlin
تجلب الدالة indexOfFirst() فهرس أول عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.
البنية العامة
يمكن استدعاء الدالة indexOfFirst() مع المصفوفات والمجموعات والقوائم:
inline fun <T> Array<out T>.indexOfFirst(
predicate: (T) -> Boolean
): Int
inline fun ByteArray.indexOfFirst(
predicate: (Byte) -> Boolean
): Int
inline fun ShortArray.indexOfFirst(
predicate: (Short) -> Boolean
): Int
inline fun IntArray.indexOfFirst(
predicate: (Int) -> Boolean
): Int
inline fun LongArray.indexOfFirst(
predicate: (Long) -> Boolean
): Int
inline fun FloatArray.indexOfFirst(
predicate: (Float) -> Boolean
): Int
inline fun DoubleArray.indexOfFirst(
predicate: (Double) -> Boolean
): Int
inline fun BooleanArray.indexOfFirst(
predicate: (Boolean) -> Boolean
): Int
inline fun CharArray.indexOfFirst(
predicate: (Char) -> Boolean
): Int
inline fun <T> Iterable<T>.indexOfFirst(
predicate: (T) -> Boolean
): Int
inline fun <T> List<T>.indexOfFirst(
predicate: (T) -> Boolean
): Int
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)).
المعاملات
predicate
دالةٌ تمثل الشرط الذي سيطبَّق على كل عنصر من عناصر المصفوفة أو المجموعة أو القائمة المعطاة، إذ يمرر إليها العنصر ثم تعيد قيمة منطقية مقابلة له.
القيم المعادة
يُعاد فهرس أول عنصر حقَّق الشرط المنطقي predicate المعطى في المصفوفة أو المجموعة أو القائمة المعطاة، أو القيمة -1 إن لم يتطابق أيُّ عنصرٍ مع ذلك الشرط.
أمثلة
تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثم تستخدم الدالة ()indexOfFirst لجلب فهرس أول عنصر أكبر من العدد 2 وأصغر من الصفر:
fun main(args: Array<String>) {
val array = arrayOf(1, 2, 3, 4, 5, 6)
print(array.indexOfFirst { it > 2 }) // 2
print(array.indexOfFirst { it < 0 }) // -1
}
انظر أيضًا
- الدالة
indexOf(): تجلب فهرس أول ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. - الدالة
indexOfLast(): تجلب فهرس آخر عنصر يحقِّق شرطًا معيَّنًا من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. - التابع
Array.get(): تجلب قيمة العنصر في المصفوفة عند الفهرس المُحدَّد. - الدالة
sliceArray() : تقطع جزءًا محدَّدًا من المصفوفة التي استُدعيت معها ثمَّ تعيده في مصفوفة أو قائمة بحسب الوسيط الممرر إليها. - الخاصية
lastIndex: تجلب الفهرس الأخير لمصفوفة أو قائمة.