الفرق بين المراجعتين ل"Kotlin/collections/fold"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>fold()</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>fold()</code> Kotlin/collections/List|ل...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>fold()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>fold()</code> في لغة Kotlin}}</noinclude> | ||
| − | + | يختلف سلوك الدالة<code>fold()</code> حسب نوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة البنية العامة). | |
==البنية العامة== | ==البنية العامة== | ||
| − | + | <syntaxhighlight lang="kotlin"> | |
| − | fun <T> Array<out | + | 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> | + | </syntaxhighlight>ستُراكِم الدالة<code>fold()</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وكل عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. وستُعيد القيمة النهائية.<syntaxhighlight lang="kotlin"> |
| − | fun <T> | + | 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> | ||
| + | </syntaxhighlight>تُجمّع الدالة<code>fold()</code> القيم من المصدر <code>[[Kotlin/collections/Grouping|Grouping]]</code> حسب المفاتيح (keys) وتطبّق العملية <code>operation</code> على عناصر كل مجموعة (group) بشكل متتابع، فتُمرّر قيمة التراكم الراهنة والعنصر الراهن كوسيطين (arguments)، وتخزّن النتائج في [[Kotlin/collections/Map|قاموس]] جديد. القيمة الأولية توفّرها الدالة <code>initialValueSelector</code> التي تُزوّد الدالة <code>fold()</code> بقيمة أولية لكل مجموعة (group). ثم تعيد [[Kotlin/collections/Map|قاموسًا]] يربط بين مفاتيح كل مجموعة (group) مع نتيجة تراكم عناصرها.<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>fold()</code> القيم من المصدر <code>[[Kotlin/collections/Grouping|Grouping]]</code> حسب المفاتيح (keys) وتطبّق العملية <code>operation</code> على عناصر كل مجموعة (group) بشكل متتابع، فتُمرّر قيمة التراكم الراهنة والعنصر الراهن كوسيطين (arguments)، وتخزّن النتائج في [[Kotlin/collections/Map|قاموس]] جديد. القيمة الأولية هي الوسيط الممرّر <code>initialValue</code>. ثم تعيد [[Kotlin/collections/Map|قاموسًا]] يربط بين مفاتيح كل مجموعة (group) مع نتيجة تراكم عناصرها. | ||
| + | |||
| + | يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
| − | |||
==القيم المٌعادة== | ==القيم المٌعادة== | ||
| − | + | انظر فقرة البنية العامة | |
==أمثلة== | ==أمثلة== | ||
| − | ===استخدام الدالة <code>() | + | ===استخدام الدالة <code>()fold</code> مع المصفوفات=== |
| − | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code> | + | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()fold</code> على <code>array</code> بتمرير القيمة الأوّلية <code>0</code> إضافة إلى عملية الإضافة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> |
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | val | + | val array = arrayOf(1,2,3,4,5,6) |
| − | |||
| − | |||
| − | |||
| − | ) | ||
| − | + | val acc = array.fold(0) { sum, element -> sum + element } | |
| − | + | print(acc) // 21 | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
| − | *<code>[[Kotlin/collections/find| | + | * صفحة الدالة<code>[[Kotlin/collections/find|foldIndexed()]]</code> |
| − | + | ||
==مصادر== | ==مصادر== | ||
| − | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/ | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/fold.html الدالة fold() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 19:03، 16 مايو 2018
يختلف سلوك الدالةfold() حسب نوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة البنية العامة).
البنية العامة
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
ستُراكِم الدالةfold() القيم بدءًا من القيمة المُمرّرة initial وتطبّق العملية operation من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وكل عناصر المصفوفة أو المجموعة التي استُدعيت عبرها. وستُعيد القيمة النهائية.
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>
تُجمّع الدالةfold() القيم من المصدر Grouping حسب المفاتيح (keys) وتطبّق العملية operation على عناصر كل مجموعة (group) بشكل متتابع، فتُمرّر قيمة التراكم الراهنة والعنصر الراهن كوسيطين (arguments)، وتخزّن النتائج في قاموس جديد. القيمة الأولية توفّرها الدالة initialValueSelector التي تُزوّد الدالة fold() بقيمة أولية لكل مجموعة (group). ثم تعيد قاموسًا يربط بين مفاتيح كل مجموعة (group) مع نتيجة تراكم عناصرها.
inline fun <T, K, R> Grouping<T, K>.fold(
initialValue: R,
operation: (accumulator: R, element: T) -> R
): Map<K, R>
تُجمّع الدالةfold() القيم من المصدر Grouping حسب المفاتيح (keys) وتطبّق العملية operation على عناصر كل مجموعة (group) بشكل متتابع، فتُمرّر قيمة التراكم الراهنة والعنصر الراهن كوسيطين (arguments)، وتخزّن النتائج في قاموس جديد. القيمة الأولية هي الوسيط الممرّر initialValue. ثم تعيد قاموسًا يربط بين مفاتيح كل مجموعة (group) مع نتيجة تراكم عناصرها.
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المٌعادة
انظر فقرة البنية العامة
أمثلة
استخدام الدالة ()fold مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()fold على array بتمرير القيمة الأوّلية 0 إضافة إلى عملية الإضافة، ثم تطبع الناتج:
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
}
انظر أيضًا
- صفحة الدالة
foldIndexed()