عرض مصدر Kotlin/collections/groupingBy

<noinclude>{{DISPLAYTITLE: الدالة <code>groupingBy()‎</code> في Kotlin}}</noinclude>
تُنشئ الدالة <code>groupingBy()‎</code> موردًا (source) من النوع <code>Grouping</code> من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold operations) وذلك باستخدام الدالة <code>keySelector</code> المُمرّرة إليها لاستخلاص مفتاح من كل عنصر.
==البنية العامة==
'''الإصدار المطلوب''': Kotlin 1.1.

يمكن  استدعاء الدالة <code>groupByTo()‎</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/Array|المجموعات]]:<syntaxhighlight lang="kotlin">
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>
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).

== المعاملات ==

=== <code>keySelector</code> ===
الدالة المستعملة في استخلاص مفتاح من كل عنصر.

==القيم المعادة==
يُعاد موردٌ من النوع <code>Grouping</code> من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold).
==أمثلة==
توضح الشيفرة الآتية كيفيَّة إنشاء كائن من النوع <code>Grouping</code> باستخدام الدالة <code>()groupingBy</code> يستعمل لتجميع الأحرف الأولى من كل سلسلة نصية بحسب عدد مرات تكرارها:<syntaxhighlight lang="kotlin">
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}
}
</syntaxhighlight>
==انظر أيضًا==
* الدالة <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]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]