الفرق بين المراجعتين ل"Kotlin/collections/reduce"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>reduce()</code> في لغة Kotlin}}</noinclude> يختلف سلوك الدالة<code>reduce()</code> حسب نوع...') |
|||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>reduce()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>reduce()</code> في لغة Kotlin}}</noinclude> | ||
− | يختلف سلوك الدالة<code>reduce()</code> حسب نوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة [[Kotlin/collections/ | + | يختلف سلوك الدالة<code>reduce()</code> حسب نوع الكائنات التي استُدعيت عبرها ونوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة [[Kotlin/collections/reduce#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]). |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
− | inline fun <T | + | inline fun <S, T : S> Array<out T>.reduce( |
− | + | operation: (acc: S, T) -> S | |
− | operation: (acc: | + | ): S |
− | ): | + | inline fun ByteArray.reduce( |
− | inline fun | + | operation: (acc: Byte, Byte) -> Byte |
− | + | ): Byte | |
− | operation: (acc: | + | inline fun ShortArray.reduce( |
− | ): | + | operation: (acc: Short, Short) -> Short |
− | inline fun | + | ): Short |
− | + | inline fun IntArray.reduce( | |
− | operation: (acc: | + | operation: (acc: Int, Int) -> Int |
− | ): | + | ): Int |
− | inline fun | + | inline fun LongArray.reduce( |
− | + | operation: (acc: Long, Long) -> Long | |
− | operation: (acc: | + | ): Long |
− | ): | + | inline fun FloatArray.reduce( |
− | inline fun | + | operation: (acc: Float, Float) -> Float |
− | + | ): Float | |
− | operation: (acc: | + | inline fun DoubleArray.reduce( |
− | ): | + | operation: (acc: Double, Double) -> Double |
− | inline fun | + | ): Double |
− | + | inline fun BooleanArray.reduce( | |
− | operation: (acc: | + | operation: (acc: Boolean, Boolean) -> Boolean |
− | ): | + | ): Boolean |
− | inline fun | + | inline fun CharArray.reduce( |
− | + | operation: (acc: Char, Char) -> Char | |
− | operation: (acc: | + | ): Char |
− | ): | + | inline fun <S, T : S> Iterable<T>.reduce( |
− | inline fun | + | operation: (acc: S, T) -> S |
− | + | ): S | |
− | operation: (acc: | ||
− | ): | ||
− | inline fun | ||
− | |||
− | operation: (acc: | ||
− | ): | ||
− | inline fun <T | ||
− | |||
− | operation: (acc: | ||
− | ): | ||
− | </syntaxhighlight>تُراكِم الدالة<code>reduce()</code> القيم بدءًا من | + | </syntaxhighlight>تُراكِم الدالة<code>reduce()</code> القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. ثم تُعيد القيمة النهائية.<syntaxhighlight lang="kotlin"> |
− | inline fun <T, K | + | inline fun <S, T : S, K> Grouping<T, K>.reduce( |
− | + | operation: (key: K, accumulator: S, element: T) -> S | |
− | operation: (key: K, accumulator: | + | ): Map<K, S> |
− | ): Map<K, | + | </syntaxhighlight>'''بيئة التشغيل: Kotlin 1.1''' |
− | </syntaxhighlight>تُجمّع الدالة<code>reduce()</code> القيم من المصدر <code>[[Kotlin/collections/Grouping|Grouping]]</code> حسب المفاتيح (keys) وتطبّق العملية <code>operation</code> على عناصر كل مجموعة (group) بشكل | + | |
− | + | تُجمّع الدالة<code>reduce()</code> القيم من المصدر <code>[[Kotlin/collections/Grouping|Grouping]]</code> حسب المفاتيح (keys) وتطبّق العملية <code>operation</code> على عناصر كل مجموعة (group) بشكل متتابع بدءًا بالعنصر الثاني من المجموعة (group)، فتُمرّر قيمة التراكم الراهنة والعنصر الراهن كوسيطين (arguments)، وتخزّن النتائج في [[Kotlin/collections/Map|قاموس]] جديد، القيمة الأولية المُمرّرة إلى المراكم <code>accumulator</code> هي العنصر الأول في المجموعة (group). | |
− | + | ||
− | + | تعيد الدالة<code>reduce()</code> [[Kotlin/collections/Map|قاموسًا]] يربط بين مفاتيح كل مجموعة (group) مع نتيجة تراكم عناصرها. | |
− | |||
− | |||
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
==القيم المٌعادة== | ==القيم المٌعادة== | ||
− | انظر فقرة [[Kotlin/collections/ | + | انظر فقرة [[Kotlin/collections/reduce#.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>()reduce</code> مع المصفوفات=== | ===استخدام الدالة <code>()reduce</code> مع المصفوفات=== | ||
− | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()reduce</code> على <code>array</code> بتمرير | + | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()reduce</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. | + | val acc = array.reduce { sum, element -> sum + element } |
print(acc) // 21 | print(acc) // 21 | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
− | * <code>[[Kotlin/collections/ | + | * <code>[[Kotlin/collections/reduceIndexed|reduceIndexed()]]</code>: تُراكِم القيم بدءًا من العنصر الأول وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية. |
==مصادر== | ==مصادر== | ||
− | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/ | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/reduce.html الدالة reduce() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] |
مراجعة 15:41، 3 يونيو 2018
يختلف سلوك الدالةreduce()
حسب نوع الكائنات التي استُدعيت عبرها ونوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة البنية العامة).
البنية العامة
inline fun <S, T : S> Array<out T>.reduce(
operation: (acc: S, T) -> S
): S
inline fun ByteArray.reduce(
operation: (acc: Byte, Byte) -> Byte
): Byte
inline fun ShortArray.reduce(
operation: (acc: Short, Short) -> Short
): Short
inline fun IntArray.reduce(
operation: (acc: Int, Int) -> Int
): Int
inline fun LongArray.reduce(
operation: (acc: Long, Long) -> Long
): Long
inline fun FloatArray.reduce(
operation: (acc: Float, Float) -> Float
): Float
inline fun DoubleArray.reduce(
operation: (acc: Double, Double) -> Double
): Double
inline fun BooleanArray.reduce(
operation: (acc: Boolean, Boolean) -> Boolean
): Boolean
inline fun CharArray.reduce(
operation: (acc: Char, Char) -> Char
): Char
inline fun <S, T : S> Iterable<T>.reduce(
operation: (acc: S, T) -> S
): S
تُراكِم الدالةreduce()
القيم بدءًا من العنصر الأول وتطبّق العملية operation
من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في المصفوفة أو المجموعة التي استُدعيت عبرها. ثم تُعيد القيمة النهائية.
inline fun <S, T : S, K> Grouping<T, K>.reduce(
operation: (key: K, accumulator: S, element: T) -> S
): Map<K, S>
بيئة التشغيل: Kotlin 1.1
تُجمّع الدالةreduce()
القيم من المصدر Grouping
حسب المفاتيح (keys) وتطبّق العملية operation
على عناصر كل مجموعة (group) بشكل متتابع بدءًا بالعنصر الثاني من المجموعة (group)، فتُمرّر قيمة التراكم الراهنة والعنصر الراهن كوسيطين (arguments)، وتخزّن النتائج في قاموس جديد، القيمة الأولية المُمرّرة إلى المراكم accumulator
هي العنصر الأول في المجموعة (group).
تعيد الدالةreduce()
قاموسًا يربط بين مفاتيح كل مجموعة (group) مع نتيجة تراكم عناصرها.
يُلاحَظ وجود الكلمة المفتاحية inline
للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المٌعادة
انظر فقرة البنية العامة.
أمثلة
استخدام الدالة ()reduce
مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم array
مكونة من ستة أعداد باستخدام الدالة ()arrayOf
، ثم تستخدم الدالة ()reduce
على array
بتمرير دالة تجمع الوسيطين المُمرّرين إليها، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
val acc = array.reduce { sum, element -> sum + element }
print(acc) // 21
}
انظر أيضًا
reduceIndexed()
: تُراكِم القيم بدءًا من العنصر الأول وتطبّق العمليةoperation
من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من المصفوفة أو المجموعة التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.