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

<noinclude>{{DISPLAYTITLE: الدالة <code>fold()‎</code> في Kotlin}}</noinclude>
يختلف سلوك الدالة <code>fold()‎</code> بحسب نوع الكائنات المستدعاة معها، و نوع المعاملات المُمرّرة إليها (انظر قسم "[[Kotlin/collections/fold#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]"). 
==البنية العامة==
تجمع الدالة <code>fold()‎</code> بشكل تراكمي ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (من اليسار إلى اليمين) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت. <syntaxhighlight lang="kotlin">
inline fun <T, R> Array<out T>.fold(
    initial: R, 
    operation: (acc: R, T) -> R
): R 
inline fun <R> ByteArray.fold(
    initial: R, 
    operation: (acc: R, Byte) -> R
): R 
inline fun <R> ShortArray.fold(
    initial: R, 
    operation: (acc: R, Short) -> R
): R 
inline fun <R> IntArray.fold(
    initial: R, 
    operation: (acc: R, Int) -> R
): R 
inline fun <R> LongArray.fold(
    initial: R, 
    operation: (acc: R, Long) -> R
): R 
inline fun <R> FloatArray.fold(
    initial: R, 
    operation: (acc: R, Float) -> R
): R 
inline fun <R> DoubleArray.fold(
    initial: R, 
    operation: (acc: R, Double) -> R
): R 
inline fun <R> BooleanArray.fold(
    initial: R, 
    operation: (acc: R, Boolean) -> R
): R 
inline fun <R> CharArray.fold(
    initial: R, 
    operation: (acc: R, Char) -> R
): R 
inline fun <T, R> Iterable<T>.fold(
    initial: R, 
    operation: (acc: R, T) -> R
): R 

</syntaxhighlight>'''الإصدار المطلوب:''' Kotlin 1.1.

تُجمِّع الدالة <code>fold()‎</code> العناصر من المصدر <code>[[Kotlin/collections/Grouping|Grouping]]</code> في مجموعات بحسب المفاتيح (keys) ثمَّ تطبّق العملية <code>operation</code> على عناصر كل مجموعة بشكل متتابع، إذ تُمرّر القيمة المتراكمة الراهنة والعنصر الراهن كوسيطين وتخزّن النتائج في [[Kotlin/collections/Map|خريطة]] جديدة. توفّر الدالة <code>initialValueSelector</code> قيمة أولية لكل مجموعة.<syntaxhighlight lang="kotlin">
inline fun <T, K, R> Grouping<T, K>.fold(
    initialValueSelector: (key: K, element: T) -> R, 
    operation: (key: K, accumulator: R, element: T) -> R
): Map<K, R>
</syntaxhighlight>'''الإصدار المطلوب:''' Kotlin 1.1

تُجمّع الدالة <code>fold()‎</code> العناصر من المصدر <code>[[Kotlin/collections/Grouping|Grouping]]</code> في مجموعات بحسب المفاتيح (keys) ثمَّ تطبّق العملية <code>operation</code> على عناصر كل مجموعة بشكل متتابع، إذ تُمرّر القيمة المتراكمة الراهنة والعنصر الراهن كوسيطين وتخزّن النتائج في [[Kotlin/collections/Map|خريطة]] جديدة. تعطى القيمة الأولية عبر تمرير قيمة للوسيط <code>initialValue</code>.<syntaxhighlight lang="kotlin">
inline fun <T, K, R> Grouping<T, K>.fold(
    initialValue: R, 
    operation: (accumulator: R, element: T) -> R
): Map<K, R>
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).

==القيم المعادة==
تُعاد خريطةٌ تربط بين مفاتيح كل مجموعة مع نتيجة جمع جميع عناصرها بشكل تراكمي. 
==أمثلة==
===استخدام الدالة <code>()fold</code> مع المصفوفات===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code>، ثمَّ تستخدم الدالة <code>()fold</code> معها لجمع عناصرها بشكل تراكمي:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)

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

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