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

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

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

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

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

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

المعاملات

`operation`

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

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

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

أمثلة

استعمال الدالة ()reduceRight لجمع الأعداد الموجودة في مصفوفة تراكميًّا:

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

    val acc = array.reduceRight { acc, element -> acc + element }
    print(acc) // 21
}

انظر أيضًا

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

مصادر

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

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