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

من موسوعة حسوب
لا ملخص تعديل
طلا ملخص تعديل
 
(5 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>foldRightIndexed()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>foldRightIndexed()‎</code> في Kotlin}}</noinclude>
تُراكِم الدالة<code>foldRightIndexed()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.  
تجمع الدالة <code>foldRightIndexed()‎</code> ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت. 
==البنية العامة==
==البنية العامة==
يمكن استدعاء الدالة<code>foldRightIndexed()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
يمكن استدعاء الدالة <code>foldRightIndexed()‎</code> مع [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
inline fun <T, R> Array<out T>.foldRightIndexed(
inline fun <T, R> Array<out T>.foldRightIndexed(
     initial: R,  
     initial: R,  
سطر 39: سطر 39:
     operation: (index: Int, Char, acc: R) -> R
     operation: (index: Int, Char, acc: R) -> R
): R  
): R  
</syntaxhighlight>يمكن استدعاء غلدالة<code>foldRightIndexed()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
</syntaxhighlight>ويمكن استدعاؤها مع [[Kotlin/collections|المجموعات]] أيضًا:<syntaxhighlight lang="kotlin">
inline fun <T, R> List<T>.foldRightIndexed(
inline fun <T, R> List<T>.foldRightIndexed(
     initial: R,  
     initial: R,  
     operation: (index: Int, T, acc: R) -> R
     operation: (index: Int, 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>initial</code> ===
قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة <code>operation</code> على أول عنصر من عناصر المصفوفة أو المجموعة المعطاة لبدء عملية التجميع.
 
=== <code>operation</code> ===
دالةٌ تمثل العملية المراد تطبيقها على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة، إذ يمرَّر إليها فهرس العنصر <code>index</code>، وقيمة كل عنصر من عناصر المصفوفة أو المجموعة المعطاة <code>T</code>، والقيمة المجمعة الحالية <code>acc</code>، ثم تعيد القيمة المجمَّعة <code>acc</code> التالية.
 
==القيم المعادة==
يعاد الناتج النهائي التراكمي لتطبيق العملية <code>operation</code> المعطاة على كل عنصر من عناصر [[Kotlin/Array|مصفوفة]] أو [[Kotlin/collections|مجموعة]] (بدءًا من اليمين إلى اليسار) مع فهرس ذلك العنصر مضافًا إليه القيمة الأولية <code>initial</code> إن أعطيت. 
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()foldRightIndexed</code> مع المصفوفات===
تعرِّف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()foldRightIndexed</code> لجمع ناتج ضرب قيمة كل عنصر من عناصر تلك الصفوفة بفهرسه تراكميًّا:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()foldRightIndexed</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.foldRightIndexed(0) { acc , element , index -> acc + element*index }
    val acc = array.foldRightIndexed(0) { acc, element, index -> acc + element * index }
print(acc) // 719
    print(acc) // 719
}
}
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا==
==انظر أيضًا==
<code>[[Kotlin/collections/foldRight|foldRight()]]</code>‎:تُراكِم  القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. وتُعيد القيمة النهائية. 
* الدالة <code>[[Kotlin/collections/foldIndexed|foldIndexed()]]</code>‎: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.
 
* الدالة <code>[[Kotlin/collections/foldRight|foldRight()]]</code>‎: تجمع بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت. 
<code>[[Kotlin/collections/foldIndexed|foldIndexed()]]</code>‎: تُراكِم القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية. 
* الدالة <code>[[Kotlin/collections/reduceRightIndexed|reduceRightIndexed()‎]]</code>: تجمع الناتج التراكمي لتطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر والقيمة المجمَّعة الحالية.


==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/fold-right-indexed.html الدالة  foldRightIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/fold-right-indexed.html صفحة الدالة foldRightIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

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

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

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

يمكن استدعاء الدالة foldRightIndexed()‎ مع المصفوفات:

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

ويمكن استدعاؤها مع المجموعات أيضًا:

inline fun <T, R> List<T>.foldRightIndexed(
    initial: R, 
    operation: (index: Int, T, acc: R) -> R
): R

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

المعاملات

initial

قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة operation على أول عنصر من عناصر المصفوفة أو المجموعة المعطاة لبدء عملية التجميع.

operation

دالةٌ تمثل العملية المراد تطبيقها على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة، إذ يمرَّر إليها فهرس العنصر index، وقيمة كل عنصر من عناصر المصفوفة أو المجموعة المعطاة T، والقيمة المجمعة الحالية acc، ثم تعيد القيمة المجمَّعة acc التالية.

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

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

أمثلة

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

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

    val acc = array.foldRightIndexed(0) { acc, element, index -> acc + element * index }
    print(acc) // 719
}

انظر أيضًا

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

مصادر