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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>fold()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>fold()‎</code> Kotlin/collections/List|ل...'
 
طلا ملخص تعديل
 
(8 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>fold()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>fold()‎</code> في Kotlin}}</noinclude>
تعيد الدالة<code>fold()‎</code> [[Kotlin/collections/List|لائحة]] تحتوي جميع عناصر [[Kotlin/Array|المصفوفات]] أو [[Kotlin/collections|المجموعات]] التي تنتمي إلى [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.  
تجمع الدالة <code>fold()‎</code> تراكميًّا ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة التراكمية الحالية بالإضافة إلى قيمة أولية إن أعطيت، ويختلف سلوكها بحسب نوع الكائنات المستدعاة معها والمعاملات المُمرّرة إليها (انظر قسم "[[Kotlin/collections/fold#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]").  
==البنية العامة==
==البنية العامة==
يمكن استدعاء الدالة<code>flatten()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
تجمع الدالة <code>fold()‎</code> بشكل تراكمي ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (من اليسار إلى اليمين) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت. <syntaxhighlight lang="kotlin">
fun <T> Array<out Array<out T>>.flatten(): List<T>  
inline fun <T, R> Array<out T>.fold(
    initial: R,
    operation: (acc: R, T) -> R
): R
inline fun <R> ByteArray.fold(
    initial: R,
    operation: (acc: R, Byte) -> R
): R
inline fun <R> ShortArray.fold(
    initial: R,
    operation: (acc: R, Short) -> R
): R
inline fun <R> IntArray.fold(
    initial: R,
    operation: (acc: R, Int) -> R
): R
inline fun <R> LongArray.fold(
    initial: R,
    operation: (acc: R, Long) -> R
): R
inline fun <R> FloatArray.fold(
    initial: R,
    operation: (acc: R, Float) -> R
): R
inline fun <R> DoubleArray.fold(
    initial: R,
    operation: (acc: R, Double) -> R
): R
inline fun <R> BooleanArray.fold(
    initial: R,
    operation: (acc: R, Boolean) -> R
): R
inline fun <R> CharArray.fold(
    initial: R,
    operation: (acc: R, Char) -> R
): R
inline fun <T, R> Iterable<T>.fold(
    initial: R,
    operation: (acc: R, T) -> R
): R


</syntaxhighlight>يمكن استدعاء الدالة<code>flatten()‎</code> على [[Kotlin/Array|المجموعات]].<syntaxhighlight lang="kotlin">
</syntaxhighlight>'''الإصدار المطلوب:''' Kotlin 1.1.
fun <T> Iterable<Iterable<T>>.flatten(): List<T>


</syntaxhighlight>
تُجمِّع الدالة <code>fold()‎</code> العناصر من المصدر <code>[[Kotlin/collections/Grouping|Grouping]]</code> في مجموعات بحسب المفاتيح (keys) ثمَّ تطبّق العملية <code>operation</code> على عناصر كل مجموعة بشكل متتابع، إذ تُمرّر القيمة المتراكمة الراهنة والعنصر الراهن كوسيطين وتخزّن النتائج في [[Kotlin/collections/Map|خريطة]] جديدة. توفّر الدالة <code>initialValueSelector</code> قيمة أولية لكل مجموعة.<syntaxhighlight lang="kotlin">
==القيم المٌعادة==
inline fun <T, K, R> Grouping<T, K>.fold(
[[Kotlin/collections/List|لائحة]] تحتوي جميع عناصر [[Kotlin/Array|المصفوفات]] أو [[Kotlin/collections|المجموعات]] التي تنتمي إلى [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.  
    initialValueSelector: (key: K, element: T) -> R,
    operation: (key: K, accumulator: R, element: T) -> R
): Map<K, R>
</syntaxhighlight>'''الإصدار المطلوب:''' Kotlin 1.1
 
تُجمّع الدالة <code>fold()‎</code> العناصر من المصدر <code>[[Kotlin/collections/Grouping|Grouping]]</code> في مجموعات بحسب المفاتيح (keys) ثمَّ تطبّق العملية <code>operation</code> على عناصر كل مجموعة بشكل متتابع، إذ تُمرّر القيمة المتراكمة الراهنة والعنصر الراهن كوسيطين وتخزّن النتائج في [[Kotlin/collections/Map|خريطة]] جديدة. تعطى القيمة الأولية عبر تمرير قيمة للوسيط <code>initialValue</code>.<syntaxhighlight lang="kotlin">
inline fun <T, K, R> Grouping<T, K>.fold(
    initialValue: R,
    operation: (accumulator: R, element: T) -> R
): Map<K, R>
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
 
== المعاملات ==
 
=== <code>initial</code> ===
قيمة أولية يراد إضافتها مع ناتج تطبيق الدالة <code>operation</code> على أول عنصر من عناصر الكائن المعطى لبدء عملية التجميع.
 
=== <code>operation</code> ===
دالةٌ تمثل العملية المراد تطبيقها على كل عنصر من عناصر الكائن المعطى، إذ يمرَّر إليها القيمة المجمعة الحالية <code>accumulator</code> وقيمة كل عنصر <code>element</code>، وتعيد القيمة المجمَّعة التالية <code>accumulator</code>. 
 
==القيم المعادة==
تُعاد خريطةٌ تربط بين مفاتيح كل مجموعة مع نتيجة جمع جميع عناصرها بشكل تراكمي.  
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()flatten</code> مع المصفوفات===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code>، ثمَّ تستخدم الدالة <code>()fold</code> معها لجمع عناصرها بشكل تراكمي:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>deepArray</code>مكونة من ثلاثة مصفوفات باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()flatten</code> لإنشاء [[Kotlin/collections/List|لائحة]] تضم جميع عناصر  [[Kotlin/Array|المصفوفات]] المُنتمية إلى <code>deepArray</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val deepArray = arrayOf(
    val array = arrayOf(1, 2, 3, 4, 5, 6)
    arrayOf(1),
    arrayOf(2, 3),
    arrayOf(4, 5, 6)
)


println(deepArray.flatten()) // [1, 2, 3, 4, 5, 6]
    val acc = array.fold(0) { sum, element -> sum + element }
}
    print(acc) // 21
</syntaxhighlight>
===استخدام الدالة <code>()fold</code> مع اللوائح===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|لائحة]]<nowiki/> باسم <code>deepList</code>مكونة من ثلاثة [[Kotlin/Array|لوائح]] باستخدام الدالة <code>()listOf</code>، ثم تستخدم الدالة <code>()flatten</code> لإنشاء [[Kotlin/collections/List|لائحة]] تضم جميع عناصر  [[Kotlin/Array|اللوائح]] المُنتميةإلى <code>deepList</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
val deepList = listOf(listOf(1), listOf(2, 3), listOf(4, 5, 6))
println(deepList.flatten()) // [1, 2, 3, 4, 5, 6]
}
}
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا==
==انظر أيضًا==
*<code>[[Kotlin/collections/find|find()]]</code>‎: تعيد العنصر الأول من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك  أي عنصر يحقق ذلك فستعيد <code>null.</code>
* الدالة <code>[[Kotlin/collections/foldRight|foldRight()]]</code>‎: تجمع بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت. 
*<code>[[Kotlin/collections/findLast|findLast()]]</code>‎: تعيد العنصر الأخير من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك  أي عنصر يحقق ذلك فستعيد <code>null.</code>
* الدالة <code>[[Kotlin/collections/foldIndexed|foldIndexed()]]</code>‎: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليسار إلى اليمين) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.
 
* الدالة <code>[[Kotlin/collections/foldRightIndexed|foldRightIndexed()‎]]</code>: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت.  
* الدالة <code>[[Kotlin/collections/reduce|reduce()]]</code>‎: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة المتراكمة الحالية.
 
==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/flatten.html الدالة  fold()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/fold.html صفحة الدالة fold()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

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

تجمع الدالة fold()‎ تراكميًّا ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر الكائن المستدعى معها والقيمة التراكمية الحالية بالإضافة إلى قيمة أولية إن أعطيت، ويختلف سلوكها بحسب نوع الكائنات المستدعاة معها والمعاملات المُمرّرة إليها (انظر قسم "البنية العامة").

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

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

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

الإصدار المطلوب: Kotlin 1.1. تُجمِّع الدالة fold()‎ العناصر من المصدر Grouping في مجموعات بحسب المفاتيح (keys) ثمَّ تطبّق العملية operation على عناصر كل مجموعة بشكل متتابع، إذ تُمرّر القيمة المتراكمة الراهنة والعنصر الراهن كوسيطين وتخزّن النتائج في خريطة جديدة. توفّر الدالة initialValueSelector قيمة أولية لكل مجموعة.

inline fun <T, K, R> Grouping<T, K>.fold(
    initialValueSelector: (key: K, element: T) -> R, 
    operation: (key: K, accumulator: R, element: T) -> R
): Map<K, R>

الإصدار المطلوب: Kotlin 1.1 تُجمّع الدالة fold()‎ العناصر من المصدر Grouping في مجموعات بحسب المفاتيح (keys) ثمَّ تطبّق العملية operation على عناصر كل مجموعة بشكل متتابع، إذ تُمرّر القيمة المتراكمة الراهنة والعنصر الراهن كوسيطين وتخزّن النتائج في خريطة جديدة. تعطى القيمة الأولية عبر تمرير قيمة للوسيط initialValue.

inline fun <T, K, R> Grouping<T, K>.fold(
    initialValue: R, 
    operation: (accumulator: R, element: T) -> R
): Map<K, R>

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

المعاملات

initial

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

operation

دالةٌ تمثل العملية المراد تطبيقها على كل عنصر من عناصر الكائن المعطى، إذ يمرَّر إليها القيمة المجمعة الحالية accumulator وقيمة كل عنصر element، وتعيد القيمة المجمَّعة التالية accumulator. 

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

تُعاد خريطةٌ تربط بين مفاتيح كل مجموعة مع نتيجة جمع جميع عناصرها بشكل تراكمي.

أمثلة

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

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

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

انظر أيضًا

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

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/collections/fold&oldid=17115»