الفرق بين المراجعتين ل"Kotlin/collections/groupingBy"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق.) |
|||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: الدالة <code>groupingBy()</code> في | + | <noinclude>{{DISPLAYTITLE: الدالة <code>groupingBy()</code> في Kotlin}}</noinclude> |
| − | تُنشئ الدالة<code>groupingBy()</code> | + | تُنشئ الدالة <code>groupingBy()</code> موردًا (source) من النوع <code>Grouping</code> من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold operations) وذلك باستخدام الدالة <code>keySelector</code> المُمرّرة إليها لاستخلاص مفتاح من كل عنصر. |
==البنية العامة== | ==البنية العامة== | ||
| − | يمكن استدعاء الدالة<code>groupByTo()</code> | + | '''الإصدار المطلوب''': Kotlin 1.1. |
| + | |||
| + | يمكن استدعاء الدالة <code>groupByTo()</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/Array|المجموعات]]:<syntaxhighlight lang="kotlin"> | ||
inline fun <T, K> Array<out T>.groupingBy( | inline fun <T, K> Array<out T>.groupingBy( | ||
crossinline keySelector: (T) -> K | crossinline keySelector: (T) -> K | ||
): Grouping<T, K> | ): Grouping<T, K> | ||
| − | + | ||
inline fun <T, K> Iterable<T>.groupingBy( | inline fun <T, K> Iterable<T>.groupingBy( | ||
crossinline keySelector: (T) -> K | crossinline keySelector: (T) -> K | ||
): Grouping<T, K> | ): Grouping<T, K> | ||
| − | </syntaxhighlight> | + | </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). |
==القيم المٌعادة== | ==القيم المٌعادة== | ||
| − | + | يُعاد موردٌ من النوع <code>Grouping</code> من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold). | |
==أمثلة== | ==أمثلة== | ||
| − | + | توضح الشيفرة الآتية كيفيَّة إنشاء كائن من النوع <code>Grouping</code> باستخدام الدالة <code>()groupingBy</code> يستعمل لتجميع الأحرف الأولى من كل سلسلة نصية بحسب عدد مرات تكرارها:<syntaxhighlight lang="kotlin"> | |
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | val | + | val words = "one two three four five six seven eight nine ten".split(' ') |
| − | + | val frequenciesByFirstChar = words.groupingBy { it.first() }.eachCount() | |
| − | val | + | println("Counting first letters:") |
| − | + | println(frequenciesByFirstChar) // {o=1, t=3, f=2, s=2, e=1, n=1} | |
| − | + | ||
| + | val moreWords = "eleven twelve".split(' ') | ||
| + | val moreFrequencies = moreWords.groupingBy { it.first() }.eachCountTo(frequenciesByFirstChar.toMutableMap()) | ||
| + | println(moreFrequencies) // {o=1, t=4, f=2, s=2, e=2, n=1} | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | == | + | ==انظر أيضًا== |
| − | <code>[[Kotlin/collections/ | + | * الدالة <code>[[Kotlin/collections/groupBy|groupBy()]]</code> : تجمِّع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها في مجموعات، إذ تطبق دالة محدَّدة على كل عنصر ثمَّ تعاد خريطة تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من العناصر المقابلة. |
| + | |||
| + | * الدالة <code>[[Kotlin/collections/groupByTo|groupByTo()]]</code>: تشبه الدالة <code>[[Kotlin/collections/groupBy|groupBy()]]</code> في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. | ||
| + | * الدالة <code>[[Kotlin/collections/foldRightIndexed|foldRightIndexed()]]</code>: تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت. | ||
| + | * الدالة <code>[[Kotlin/collections/foldRight|foldRight()]]</code>: تجمع بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت. | ||
| − | |||
==مصادر== | ==مصادر== | ||
| − | [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/grouping-by.html الدالة groupingBy() في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin] | + | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/grouping-by.html صفحة الدالة groupingBy() في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 06:00، 24 يوليو 2018
تُنشئ الدالة groupingBy() موردًا (source) من النوع Grouping من المصفوفة أو المجموعة التي استُدعيت معها لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold operations) وذلك باستخدام الدالة keySelector المُمرّرة إليها لاستخلاص مفتاح من كل عنصر.
البنية العامة
الإصدار المطلوب: Kotlin 1.1.
يمكن استدعاء الدالة groupByTo() مع المصفوفات والمجموعات:
inline fun <T, K> Array<out T>.groupingBy(
crossinline keySelector: (T) -> K
): Grouping<T, K>
inline fun <T, K> Iterable<T>.groupingBy(
crossinline keySelector: (T) -> K
): Grouping<T, K>
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).
القيم المٌعادة
يُعاد موردٌ من النوع Grouping من المصفوفة أو المجموعة المعطاة لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold).
أمثلة
توضح الشيفرة الآتية كيفيَّة إنشاء كائن من النوع Grouping باستخدام الدالة ()groupingBy يستعمل لتجميع الأحرف الأولى من كل سلسلة نصية بحسب عدد مرات تكرارها:
fun main(args: Array<String>) {
val words = "one two three four five six seven eight nine ten".split(' ')
val frequenciesByFirstChar = words.groupingBy { it.first() }.eachCount()
println("Counting first letters:")
println(frequenciesByFirstChar) // {o=1, t=3, f=2, s=2, e=1, n=1}
val moreWords = "eleven twelve".split(' ')
val moreFrequencies = moreWords.groupingBy { it.first() }.eachCountTo(frequenciesByFirstChar.toMutableMap())
println(moreFrequencies) // {o=1, t=4, f=2, s=2, e=2, n=1}
}
انظر أيضًا
- الدالة
groupBy(): تجمِّع عناصر المصفوفة أو المجموعة التي استُدعيت معها في مجموعات، إذ تطبق دالة محدَّدة على كل عنصر ثمَّ تعاد خريطة تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من العناصر المقابلة.
- الدالة
groupByTo(): تشبه الدالةgroupBy()في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. - الدالة
foldRightIndexed(): تجمع ناتج تطبيق عملية معينة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها وفهرس ذلك العنصر بشكل تراكمي بالإضافة إلى القيمة الأولية إن أعطيت. - الدالة
foldRight(): تجمع بشكل تراكمي ناتج تطبيق عملية معيَّنة على قيمة كل عنصر من عناصر المصفوفة أو المجموعة (بدءًا من اليمين إلى اليسار) المستدعاة معها والقيمة التراكمية الحالية بالإضافة إلى القيمة الأولية إن أعطيت.