الدالة CharSequence.mapIndexedNotNull()‎ في Kotlin

تعيد الدالة mapIndexedNotNull()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف السلسلة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.

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

inline fun <R : Any> CharSequence.mapIndexedNotNull(
    transform: (index: Int, Char) -> R?
): List<R>

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

المعاملات

transform

دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها فهرس المحرف وقيمته وتعيد القيمة المقابلة لهذا المحرف.

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

تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform‎ المُمرّرة على فهرس وقيمة كل عنصر من عناصر محرف من محارف السلسلة المعطاة باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.

أمثلة

مثالٌ على استعمال الدالة mapIndexedNotNull()‎:

fun main(args: Array<String>) {
    val str = "Hsoub Wiki"

    print(str.mapIndexedNotNull { index, char -> if (index < 5) index + char.toInt() else null })
    // [72, 116, 113, 120, 102]
}

انظر أيضًا

• الدالة mapIndexedNotNullTo()‎: تشبه الدالة mapIndexedNotNull()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
• الدالة map()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها.
• الدالة mapNotNull()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
• الدالة mapIndexed()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف السلسلة التي استُدعيت معها.
• الدالة filterIndexed()‎: ترشِّح محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على فهرس المحرف وقيمته.

مصادر

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