الفرق بين المراجعتين لصفحة: «Kotlin/collections/reduceIndexed»

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

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

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

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

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

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

inline fun <S, T : S> Iterable<T>.reduceIndexed(
    operation: (index: Int, acc: S, T) -> S
): S

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

المعاملات

`operation`

دالة يراد تطبيقها على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة. يمرر إليها فهرس العنصر الحالي -الذي ستطبق عليه هذه الدالة-، والقيمة المتراكمة الحالية (التي تمثل عنصرًا)، وقيمة ذلك العنصر نفسه ثم تحسب قيمة العنصر المتراكم التالي.

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

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

أمثلة

استعمال الدالة ()reduceIndexed لجمع الناتج التراكمي لضرب قيمة كل عنصر من عناصر مصفوفة بقيمة فهرسه:

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()‎: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة المتراكمة الحالية.
الدالة reduceRight()‎: تجمع بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية.
الدالة reduceRightIndexed()‎: تجمع الناتج التراكمي لتطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر والقيمة المجمَّعة الحالية.
الدالة foldIndexed()‎: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>reduceIndexed()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>reduceIndexed()‎</code> في Kotlin}}</noinclude>
-تُراكِم الدالة<code>reduceIndexed()‎</code> القيم بدءًا من العنصر الأول  في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
+تجمع الدالة <code>reduceIndexed()‎</code> ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي والقيمة المجمَّعة الحالية.
 ==البنية العامة==
-<syntaxhighlight lang="kotlin">
+يمكن استدعاء الدالة <code>reduceIndexed()‎</code> مع المصفوفات:<syntaxhighlight lang="kotlin">
 inline fun <S, T : S> Array<out T>.reduceIndexed(
      operation: (index: Int, acc: S, T) -> S
@@ سطر 31: / سطر 31: @@
 ): Char
-</syntaxhighlight>تُراكِم الدالة<code>reduceIndexed()‎</code> القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.<syntaxhighlight lang="kotlin">
+</syntaxhighlight>ويمكن استدعاؤها مع المجموعات:<syntaxhighlight lang="kotlin">
 inline fun <S, T : S> Iterable<T>.reduceIndexed(
      operation: (index: Int, acc: S, T) -> S
 ): S
-</syntaxhighlight>تُراكِم الدالة<code>reduceIndexed()‎</code> القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
-يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+== المعاملات ==
-==القيم المٌعادة==
+=== <code>operation</code> ===
-قيمة التطبيق التراكُمي من اليسار إلى اليمين للعملية <code>operation</code> على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها.
+دالة يراد تطبيقها على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة. يمرر إليها فهرس العنصر الحالي -الذي ستطبق عليه هذه الدالة-، والقيمة المتراكمة الحالية (التي تمثل عنصرًا)، وقيمة ذلك العنصر نفسه ثم تحسب قيمة العنصر المتراكم التالي.
+==القيم المعادة==
+يعاد الناتج النهائي التراكمي لتطبيق العملية <code>operation</code> المعطاة على قيمة كل عنصر من عناصر <nowiki/>[[Kotlin/Array|مصفوفة]] أو <nowiki/>[[Kotlin/collections|مجموعة]] (بدءًا من اليسار إلى اليمين) مع فهرس ذلك العنصر والقيمة المتراكمة الحالية.
 ==أمثلة==
-===استخدام الدالة <code>()reduceIndexed</code> مع المصفوفات===
+<nowiki/>استعمال الدالة <code>()reduceIndexed</code> لجمع الناتج التراكمي لضرب قيمة كل عنصر من عناصر مصفوفة بقيمة فهرسه:<syntaxhighlight lang="kotlin">
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()reduceIndexed</code> على <code>array</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.reduceIndexed { acc , element , index -> acc + element*index }
+    val acc = array.reduceIndexed { acc, element, index -> acc + element * index }
-print(acc) // 1439
+    print(acc) // 1439
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-* <code>[[Kotlin/collections/reduce|reduce()]]</code>‎: تُراكِم القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي وفهرسه.
+* الدالة <code>[[Kotlin/collections/reduce|reduce()]]</code>‎: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة المتراكمة الحالية.
+*الدالة <code>[[Kotlin/collections/reduceRight|reduceRight()‎]]</code>: تجمع بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية.
+*الدالة <code>[[Kotlin/collections/reduceRightIndexed|reduceRightIndexed()‎]]</code>: تجمع الناتج التراكمي لتطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر والقيمة المجمَّعة الحالية.
+* الدالة <code>[[Kotlin/collections/foldIndexed|foldIndexed()]]</code>‎: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/reduce-indexed.html الدالة  reduceIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/reduce-indexed.html صفحة الدالة reduceIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]