عرض مصدر Kotlin/collections/foldIndexed

<noinclude>{{DISPLAYTITLE: الدالة <code>foldIndexed()‎</code> في Kotlin}}</noinclude>
تجمع الدالة <code>foldIndexed()‎</code> ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت. 
==البنية العامة==
يمكن استدعاء الدالة <code>foldIndexed()‎</code> مع [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
inline fun <T, R> Array<out T>.foldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, T) -> R
): R 
inline fun <R> ByteArray.foldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, Byte) -> R
): R 
inline fun <R> ShortArray.foldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, Short) -> R
): R 
inline fun <R> IntArray.foldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, Int) -> R
): R 
inline fun <R> LongArray.foldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, Long) -> R
): R 
inline fun <R> FloatArray.foldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, Float) -> R
): R 
inline fun <R> DoubleArray.foldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, Double) -> R
): R 
inline fun <R> BooleanArray.foldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, Boolean) -> R
): R 
inline fun <R> CharArray.foldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, Char) -> R
): R 

</syntaxhighlight>ويمكن استدعاؤها مع [[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
inline fun <T, R> Iterable<T>.foldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, T) -> R
): R
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).

== المعاملات ==

=== <code>initial</code> ===
قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة <code>operation</code> على أول عنصر من عناصر المصفوفة أو المجموعة لبدء عملية التجميع.

=== <code>operation</code> ===
دالةٌ تمثل العملية المراد تطبيقها على كل عنصر من عناصر المصفوفة أو المجموعة، إذ يمرَّر إليها فهرس المحرف <code>index</code> والقيمة المجمعة الحالية <code>acc</code> وقيمة كل عنصر من عناصر المصفوفة أو المجموعة <code>T</code>، وتعيد القيمة المجمَّعة التالية <code>acc</code>.

==القيم المعادة==
يعاد الناتج النهائي التراكمي لتطبيق العملية <code>operation</code> المعطاة على كل عنصر من عناصر [[Kotlin/Array|مصفوفة]] أو [[Kotlin/collections|مجموعة]] (بدءًا من اليسار إلى اليمين) مع فهرس ذلك العنصر مضافًا إليه القيمة الأولية <code>initial</code> إن أعطيت. 
==أمثلة==
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()foldIndexed</code> لتطبيق عملية جمع ناتج ضرب كل عنصر مع قيمة فهرسه تراكميًّا:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)

    val acc = array.foldIndexed(0) { acc, element, index -> acc + element * index }
    print(acc) // 719
}
</syntaxhighlight>
==انظر أيضًا==
* الدالة <code>[[Kotlin/collections/foldRightIndexed|foldRightIndexed()‎]]</code>: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.  
* الدالة <code>[[Kotlin/collections/foldRight|foldRight()]]</code>‎: تجمع بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت. 
* الدالة <code>[[Kotlin/collections/reduceIndexed|reduceIndexed()]]</code>‎: ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي والقيمة المجمَّعة الحالية.

==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/fold-indexed.html صفحة الدالة foldIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]