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

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

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

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

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

inline fun <S, T : S> Array<out T>.reduceRightIndexed(
    operation: (index: Int, T, acc: S) -> S
): S 
inline fun ByteArray.reduceRightIndexed(
    operation: (index: Int, Byte, acc: Byte) -> Byte
): Byte 
inline fun ShortArray.reduceRightIndexed(
    operation: (index: Int, Short, acc: Short) -> Short
): Short 
inline fun IntArray.reduceRightIndexed(
    operation: (index: Int, Int, acc: Int) -> Int
): Int
inline fun LongArray.reduceRightIndexed(
    operation: (index: Int, Long, acc: Long) -> Long
): Long 
inline fun FloatArray.reduceRightIndexed(
    operation: (index: Int, Float, acc: Float) -> Float
): Float 
inline fun DoubleArray.reduceRightIndexed(
    operation: (index: Int, Double, acc: Double) -> Double
): Double 
inline fun BooleanArray.reduceRightIndexed(
    operation: (index: Int, Boolean, acc: Boolean) -> Boolean
): Boolean 
inline fun CharArray.reduceRightIndexed(
    operation: (index: Int, Char, acc: Char) -> Char
): Char

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

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

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

المعاملات

`operation`

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

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

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

أمثلة

استعمال الدالة ()reduceRightIndexed لجمع ناتج جداء قيمة العنصر وقيمة فهرسه تراكميًّا:

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)

    val acc = array.reduceRightIndexed { acc, element, index -> acc + element * index }
    print(acc) // 839
}

انظر أيضًا

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

مصادر

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

@@ سطر 36: / سطر 36: @@
 ): S
 </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات==
+===<code>operation</code>===
+دالة يراد تطبيقها على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة. يمرر إليها فهرس العنصر الحالي -الذي ستطبق عليه هذه الدالة-، والقيمة المتراكمة الحالية (التي تمثل عنصرًا)، وقيمة ذلك العنصر نفسه ثم تحسب قيمة العنصر المتراكم التالي.
 ==القيم المعادة==
 يعاد الناتج النهائي التراكمي لتطبيق العملية <code>operation</code> المعطاة على قيمة كل عنصر من عناصر <nowiki/>[[Kotlin/Array|مصفوفة]] أو <nowiki/>[[Kotlin/collections|مجموعة]] (بدءًا من اليمين إلى اليسار) مع قيمة فهرسه والقيمة التراكمية الحالية.
@@ سطر 49: / سطر 51: @@
 </syntaxhighlight>
 ==انظر أيضًا==
-* الدالة <code>[[Kotlin/collections/reduce|reduce()]]</code>‎: تجمع قيم عناصر الكائن المستدعى معها وتطبق عملية معينة على القيمة المجمعة الحالية في كل مرة تجمَّع فيها قيم العناصر.
+* الدالة <code>[[Kotlin/collections/reduce|reduce()]]</code>‎: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة المتراكمة الحالية.
 * الدالة <code>[[Kotlin/collections/reduceIndexed|reduceIndexed()]]</code>‎: ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي والقيمة المجمَّعة الحالية.
 * الدالة <code>[[Kotlin/collections/reduceRight|reduceRight()‎]]</code>: تجمع بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية.
@@ سطر 57: / سطر 59: @@
 *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/reduce-right-indexed.html صفحة الدالة reduceRightIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]