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