الفرق بين المراجعتين ل"Kotlin/collections/foldIndexed"

المراجعة الحالية بتاريخ 08:10، 8 سبتمبر 2018

تجمع الدالة foldIndexed()‎ ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.

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

يمكن استدعاء الدالة foldIndexed()‎ مع المصفوفات:

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

ويمكن استدعاؤها مع المجموعات:

inline fun <T, R> Iterable<T>.foldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, T) -> R
): R

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

المعاملات

`initial`

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

`operation`

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

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

يعاد الناتج النهائي التراكمي لتطبيق العملية operation المعطاة على كل عنصر من عناصر مصفوفة أو مجموعة (بدءًا من اليسار إلى اليمين) مع فهرس ذلك العنصر مضافًا إليه القيمة الأولية initial إن أعطيت.

أمثلة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()foldIndexed لتطبيق عملية جمع ناتج ضرب كل عنصر مع قيمة فهرسه تراكميًّا:

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
}

انظر أيضًا

الدالة foldRightIndexed()‎: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.
الدالة foldRight()‎: تجمع بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت.
الدالة reduceIndexed()‎: ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي والقيمة المجمَّعة الحالية.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>foldIndexed()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>foldIndexed()‎</code> في Kotlin}}</noinclude>
-يختلف سلوك الدالة<code>foldIndexed()‎</code> حسب نوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة [[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>foldIndexed()‎</code> ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.
 ==البنية العامة==
-<syntaxhighlight lang="kotlin">
+يمكن استدعاء الدالة <code>foldIndexed()‎</code> مع [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
-inline fun <T, R> Array<out T>.fold(
+inline fun <T, R> Array<out T>.foldIndexed(
      initial: R,
-     operation: (acc: R, T) -> R
+     operation: (index: Int, acc: R, T) -> R
 ): R
-inline fun <R> ByteArray.fold(
+inline fun <R> ByteArray.foldIndexed(
      initial: R,
-     operation: (acc: R, Byte) -> R
+     operation: (index: Int, acc: R, Byte) -> R
 ): R
-inline fun <R> ShortArray.fold(
+inline fun <R> ShortArray.foldIndexed(
      initial: R,
-     operation: (acc: R, Short) -> R
+     operation: (index: Int, acc: R, Short) -> R
 ): R
-inline fun <R> IntArray.fold(
+inline fun <R> IntArray.foldIndexed(
      initial: R,
-     operation: (acc: R, Int) -> R
+     operation: (index: Int, acc: R, Int) -> R
 ): R
-inline fun <R> LongArray.fold(
+inline fun <R> LongArray.foldIndexed(
      initial: R,
-     operation: (acc: R, Long) -> R
+     operation: (index: Int, acc: R, Long) -> R
 ): R
-inline fun <R> FloatArray.fold(
+inline fun <R> FloatArray.foldIndexed(
      initial: R,
-     operation: (acc: R, Float) -> R
+     operation: (index: Int, acc: R, Float) -> R
 ): R
-inline fun <R> DoubleArray.fold(
+inline fun <R> DoubleArray.foldIndexed(
      initial: R,
-     operation: (acc: R, Double) -> R
+     operation: (index: Int, acc: R, Double) -> R
 ): R
-inline fun <R> BooleanArray.fold(
+inline fun <R> BooleanArray.foldIndexed(
      initial: R,
-     operation: (acc: R, Boolean) -> R
+     operation: (index: Int, acc: R, Boolean) -> R
 ): R
-inline fun <R> CharArray.fold(
+inline fun <R> CharArray.foldIndexed(
      initial: R,
-     operation: (acc: R, Char) -> R
+     operation: (index: Int, acc: R, Char) -> R
 ): R
-inline fun <T, R> Iterable<T>.fold(
+</syntaxhighlight>ويمكن استدعاؤها مع [[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
+inline fun <T, R> Iterable<T>.foldIndexed(
      initial: R,
-     operation: (acc: R, T) -> R
+     operation: (index: Int, acc: R, T) -> R
 ): R
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
-</syntaxhighlight>ستُراكِم الدالة<code>fold()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وكل عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. وستُعيد القيمة النهائية.<syntaxhighlight lang="kotlin">
+=== <code>initial</code> ===
-inline fun <T, K, R> Grouping<T, K>.fold(
+قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة <code>operation</code> على أول عنصر من عناصر المصفوفة أو المجموعة لبدء عملية التجميع.
-    initialValueSelector: (key: K, element: T) -> R,
-    operation: (key: K, accumulator: R, element: T) -> R
-): Map<K, R>
-</syntaxhighlight>تُجمّع الدالة<code>fold()‎</code> القيم من المصدر <code>[[Kotlin/collections/Grouping|Grouping]]</code> حسب المفاتيح (keys) وتطبّق العملية <code>operation</code> على عناصر كل مجموعة (group) بشكل متتابع، فتُمرّر  قيمة التراكم الراهنة والعنصر الراهن كوسيطين (arguments)، وتخزّن النتائج في [[Kotlin/collections/Map|قاموس]] جديد. القيمة الأولية توفّرها الدالة <code>initialValueSelector</code> التي تُزوّد الدالة <code>fold()‎</code> بقيمة أولية لكل مجموعة (group). ثم تعيد  [[Kotlin/collections/Map|قاموسًا]] يربط بين مفاتيح كل مجموعة (group) مع نتيجة تراكم عناصرها.<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>fold()‎</code> القيم من المصدر <code>[[Kotlin/collections/Grouping|Grouping]]</code> حسب المفاتيح (keys) وتطبّق العملية <code>operation</code> على عناصر كل مجموعة  (group) بشكل متتابع، فتُمرّر  قيمة التراكم الراهنة والعنصر الراهن كوسيطين (arguments)، وتخزّن النتائج في [[Kotlin/collections/Map|قاموس]] جديد. القيمة الأولية هي الوسيط الممرّر  <code>initialValue</code>. ثم تعيد  [[Kotlin/collections/Map|قاموسًا]] يربط بين مفاتيح كل مجموعة (group) مع نتيجة تراكم عناصرها.
-يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+=== <code>operation</code> ===
+دالةٌ تمثل العملية المراد تطبيقها على كل عنصر من عناصر المصفوفة أو المجموعة، إذ يمرَّر إليها فهرس المحرف <code>index</code> والقيمة المجمعة الحالية <code>acc</code> وقيمة كل عنصر من عناصر المصفوفة أو المجموعة <code>T</code>، وتعيد القيمة المجمَّعة التالية <code>acc</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>operation</code> المعطاة على كل عنصر من عناصر [[Kotlin/Array|مصفوفة]] أو [[Kotlin/collections|مجموعة]] (بدءًا من اليسار إلى اليمين) مع فهرس ذلك العنصر مضافًا إليه القيمة الأولية <code>initial</code> إن أعطيت.
 ==أمثلة==
-===استخدام الدالة <code>()foldIndexed</code> مع المصفوفات===
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()foldIndexed</code> لتطبيق عملية جمع ناتج ضرب كل عنصر مع قيمة فهرسه تراكميًّا:<syntaxhighlight lang="kotlin">
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()foldIndexed</code> على <code>array</code> بتمرير القيمة الأوّلية <code>0</code> إضافة إلى عملية الإضافة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val array = arrayOf(1,2,3,4,5,6)
+    val array = arrayOf(1, 2, 3, 4, 5, 6)
-val acc = array.fold(0) { sum, element -> sum + element }
+    val acc = array.foldIndexed(0) { acc, element, index -> acc + element * index }
-print(acc) // 21
+    print(acc) // 719
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-* صفحة الدالة<code>[[Kotlin/collections/find|foldIndexed()]]</code>‎
+* الدالة <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.html الدالة  foldIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/fold-indexed.html صفحة الدالة foldIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]