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