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