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

مراجعة 17:47، 3 يونيو 2018

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

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

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

تُراكِم الدالةreduceRightIndexed()‎ القيم بدءًا من العنصر الأخير وتطبّق العملية operation من اليمين إلى اليسار على العنصر الموالي في المصفوفة التي استُدعيت عبرها وعلى فهرسه وعلى القيمة المُتراكمة الراهنة. ثم تُعيد القيمة النهائية.

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

تُراكِم الدالةreduceRightIndexed()‎ القيم بدءًا من العنصر الأخير وتطبّق العملية operation من اليمين إلى اليسار على العنصر الموالي في اللائحة التي استُدعيت عبرها وعلى فهرسه وعلى القيمة المُتراكمة الراهنة. ثم تُعيد القيمة النهائية.

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

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

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

أمثلة

استخدام الدالة `()reduceRightIndexed` مع المصفوفات

تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()reduceRightIndexed على array بتمرير دالة، ثم تطبع الناتج:

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()‎: تُراكِم القيم بدءًا من العنصر الأول وتطبّق العملية operation من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي وفهرسه.
reduceIndexed()‎: تُراكِم القيم بدءًا من العنصر الأول وتطبّق العملية operation من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من المصفوفة أو المجموعة التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>reduceRightIndexed()‎</code> في لغة Kotlin}}</noinclude>
-تُراكِم الدالة<code>reduceRightIndexed()‎</code> القيم بدءًا من العنصر الأول  في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
+تُراكِم الدالة<code>reduceRightIndexed()‎</code> القيم بدءًا من العنصر الأخير في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun <S, T : S> Array<out T>.reduceIndexed(
+inline fun <S, T : S> Array<out T>.reduceRightIndexed(
-     operation: (index: Int, acc: S, T) -> S
+     operation: (index: Int, T, acc: S) -> S
 ): S
-inline fun ByteArray.reduceIndexed(
+inline fun ByteArray.reduceRightIndexed(
-     operation: (index: Int, acc: Byte, Byte) -> Byte
+     operation: (index: Int, Byte, acc: Byte) -> Byte
 ): Byte
-inline fun ShortArray.reduceIndexed(
+inline fun ShortArray.reduceRightIndexed(
-     operation: (index: Int, acc: Short, Short) -> Short
+     operation: (index: Int, Short, acc: Short) -> Short
 ): Short
-inline fun IntArray.reduceIndexed(
+inline fun IntArray.reduceRightIndexed(
-     operation: (index: Int, acc: Int, Int) -> Int
+     operation: (index: Int, Int, acc: Int) -> Int
 ): Int
-inline fun LongArray.reduceIndexed(
+inline fun LongArray.reduceRightIndexed(
-     operation: (index: Int, acc: Long, Long) -> Long
+     operation: (index: Int, Long, acc: Long) -> Long
 ): Long
-inline fun FloatArray.reduceIndexed(
+inline fun FloatArray.reduceRightIndexed(
-     operation: (index: Int, acc: Float, Float) -> Float
+     operation: (index: Int, Float, acc: Float) -> Float
 ): Float
-inline fun DoubleArray.reduceIndexed(
+inline fun DoubleArray.reduceRightIndexed(
-     operation: (index: Int, acc: Double, Double) -> Double
+     operation: (index: Int, Double, acc: Double) -> Double
 ): Double
-inline fun BooleanArray.reduceIndexed(
+inline fun BooleanArray.reduceRightIndexed(
-     operation: (index: Int, acc: Boolean, Boolean) -> Boolean
+     operation: (index: Int, Boolean, acc: Boolean) -> Boolean
 ): Boolean
-inline fun CharArray.reduceIndexed(
+inline fun CharArray.reduceRightIndexed(
-     operation: (index: Int, acc: Char, Char) -> Char
+     operation: (index: Int, Char, acc: Char) -> Char
 ): Char
-</syntaxhighlight>تُراكِم الدالة<code>reduceRightIndexed()‎</code> القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.<syntaxhighlight lang="kotlin">
+</syntaxhighlight>تُراكِم الدالة<code>reduceRightIndexed()‎</code> القيم بدءًا من العنصر الأخير وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على العنصر الموالي في [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها وعلى فهرسه وعلى القيمة المُتراكمة الراهنة. ثم تُعيد القيمة النهائية.<syntaxhighlight lang="kotlin">
-inline fun <S, T : S> Iterable<T>.reduceIndexed(
+inline fun <S, T : S> List<T>.reduceRightIndexed(
-     operation: (index: Int, acc: S, T) -> S
+     operation: (index: Int, T, acc: S) -> S
 ): S
-</syntaxhighlight>تُراكِم الدالة<code>reduceRightIndexed()‎</code> القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
+</syntaxhighlight>تُراكِم الدالة<code>reduceRightIndexed()‎</code> القيم بدءًا من العنصر الأخير وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على العنصر الموالي في [[Kotlin/List|اللائحة]] التي استُدعيت عبرها وعلى فهرسه وعلى القيمة المُتراكمة الراهنة. ثم تُعيد القيمة النهائية.
 يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المٌعادة==
-قيمة التطبيق التراكُمي من اليسار إلى اليمين للعملية <code>operation</code> على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها.
+قيمة التطبيق التراكُمي من اليمين إلى اليسار للعملية <code>operation</code> على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها.
 ==أمثلة==
 ===استخدام الدالة <code>()reduceRightIndexed</code> مع المصفوفات===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()reduceRightIndexed</code> على <code>array</code> بتمرير  دال، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()reduceRightIndexed</code> على <code>array</code> بتمرير  دالة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
 val array = arrayOf(1,2,3,4,5,6)
-val acc = array.reduceIndexed { acc , element , index -> acc + element*index }
+val acc = array.reduceRightIndexed { acc , element , index -> acc + element*index }
-print(acc) // 1439
+print(acc) // 839
 }
 </syntaxhighlight>
 ==انظر أيضًا==
 * <code>[[Kotlin/collections/reduce|reduce()]]</code>‎: تُراكِم القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي وفهرسه.
+* <code>[[Kotlin/collections/reduceIndexed|reduceIndexed()]]</code>‎: تُراكِم القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/reduce-indexed.html الدالة  reduceRightIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/reduce-right-indexed.html الدالة  reduceRightIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]