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

مراجعة 14:35، 23 يوليو 2018

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

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

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

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

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

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

أمثلة

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

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

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

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>foldRight()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>foldRight()‎</code> في Kotlin}}</noinclude>
-تُراكِم الدالة<code>foldRight()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. وتُعيد القيمة النهائية.
+تجمع الدالة <code>foldRight()‎</code> بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 43: / سطر 43: @@
      operation: (T, acc: R) -> R
 ): R
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight><nowiki/>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
-==القيم المٌعادة==
+==القيم المعادة==
-ناتج تطبيق العملية المُمرّرة <code>operation</code> تراكميًا على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
+يعاد الناتج النهائي التراكمي لتطبيق العملية <code>operation</code> المعطاة على كل عنصر من عناصر [[Kotlin/Array|مصفوفة]] أو [[Kotlin/collections|مجموعة]] (بدءًا من اليمين إلى اليسار) مع فهرس ذلك العنصر مضافًا إليه القيمة الأولية <code>initial</code> إن أعطيت.
 ==أمثلة==
-===استخدام الدالة <code>()foldRight</code> مع المصفوفات===
+تعرِّف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()foldRight</code> لجمع قيم عناصرها بشكل تراكمي:<syntaxhighlight lang="kotlin">
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()foldRight</code> على <code>array</code> بتمرير القيمة الأوّلية <code>0</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.foldRight(0) { acc , element -> acc + element }
+    val acc = array.foldRight(0) { acc, element -> acc + element }
-print(acc) // 21
+    print(acc) // 21
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-<code>[[Kotlin/collections/foldIndexed|foldIndexed()]]</code>‎: تُراكِم القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
+* الدالة <code>[[Kotlin/collections/foldRightIndexed|foldRightIndexed()‎]]</code>: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/fold-right.html الدالة  foldRight()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/fold-right.html صفحة الدالة foldRight()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]