الفرق بين المراجعتين لصفحة: «Kotlin/collections/foldRight»
< Kotlin | collections
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>foldRight()</code> في لغة Kotlin}}</noinclude> تُراكِم الدالة<code>foldRight()</code> القيم ب...' |
لا ملخص تعديل |
||
| سطر 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> من اليسار | تُراكِم الدالة<code>foldRight()</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. وتُعيد القيمة النهائية. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | |||
inline fun <T, R> Array<out T>. | inline fun <T, R> Array<out T>.foldRight( | ||
initial: R, | initial: R, | ||
operation: ( | operation: (T, acc: R) -> R | ||
): R | ): R | ||
inline fun <R> ByteArray. | inline fun <R> ByteArray.foldRight( | ||
initial: R, | initial: R, | ||
operation: ( | operation: (Byte, acc: R) -> R | ||
): R | ): R | ||
inline fun <R> ShortArray. | inline fun <R> ShortArray.foldRight( | ||
initial: R, | initial: R, | ||
operation: ( | operation: (Short, acc: R) -> R | ||
): R | ): R | ||
inline fun <R> IntArray. | inline fun <R> IntArray.foldRight( | ||
initial: R, | initial: R, | ||
operation: ( | operation: (Int, acc: R) -> R | ||
): R | ): R | ||
inline fun <R> LongArray. | inline fun <R> LongArray.foldRight( | ||
initial: R, | initial: R, | ||
operation: ( | operation: (Long, acc: R) -> R | ||
): R | ): R | ||
inline fun <R> FloatArray. | inline fun <R> FloatArray.foldRight( | ||
initial: R, | initial: R, | ||
operation: ( | operation: (Float, acc: R) -> R | ||
): R | ): R | ||
inline fun <R> DoubleArray. | inline fun <R> DoubleArray.foldRight( | ||
initial: R, | initial: R, | ||
operation: ( | operation: (Double, acc: R) -> R | ||
): R | ): R | ||
inline fun <R> BooleanArray. | inline fun <R> BooleanArray.foldRight( | ||
initial: R, | initial: R, | ||
operation: ( | operation: (Boolean, acc: R) -> R | ||
): R | ): R | ||
inline fun <R> CharArray. | inline fun <R> CharArray.foldRight( | ||
initial: R, | initial: R, | ||
operation: ( | operation: (Char, acc: R) -> R | ||
): R | ): R | ||
inline fun <T, R> List<T>.foldRight( | |||
inline fun <T, R> | |||
initial: R, | initial: R, | ||
operation: ( | operation: (T, acc: R) -> R | ||
): R | ): R | ||
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
==القيم المٌعادة== | ==القيم المٌعادة== | ||
ناتج تطبيق العملية المُمرّرة <code>operation</code> تراكميًا على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها | ناتج تطبيق العملية المُمرّرة <code>operation</code> تراكميًا على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()foldRight</code> مع المصفوفات=== | ===استخدام الدالة <code>()foldRight</code> مع المصفوفات=== | ||
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()foldRight</code> على <code>array</code> بتمرير القيمة الأوّلية <code>0</code> إضافة إلى عملية تُضيف القيمة المتراكمة الراهنة إلى | تعرف الشيفرة الآتية <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>) { | 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. | val acc = array.foldRight(0) { acc , element -> acc + element } | ||
print(acc) // | print(acc) // 21 | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
<code>[[Kotlin/collections/foldIndexed|foldIndexed()]]</code>: تُراكِم القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية. | |||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/fold- | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/fold-right.html الدالة foldRight() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 15:22، 17 مايو 2018
تُراكِم الدالةfoldRight() القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من المصفوفة أو المجموعة التي استُدعيت عبرها. وتُعيد القيمة النهائية.
البنية العامة
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 تراكميًا على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.
أمثلة
استخدام الدالة ()foldRight مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()foldRight على array بتمرير القيمة الأوّلية 0 إضافة إلى عملية تُضيف القيمة المتراكمة الراهنة إلى عناصر array، ثم تطبع الناتج:
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
}
انظر أيضًا
foldIndexed(): تُراكِم القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من المصفوفة أو المجموعة التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.