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

مراجعة 13:19، 25 مايو 2018

تُنشئ الدالةgroupingBy()‎ كائنًا من النوع Grouping من المصفوفة أو المجموعة التي استُدعيت عبرها لاستخدامه لاحقًا مع عمليات المجموعات (group-and-fold operations)، وذلك باستخدام الدالة المُمرّرة keySelector لاستخلاص مفتاح من كل عنصر .

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

يمكن استدعاء الدالةgroupByTo()‎ عبر المصفوفات:

inline fun <T, K> Array<out T>.groupingBy(
    crossinline keySelector: (T) -> K
): Grouping<T, K>

يمكن استدعاء الدالةgroupByTo()‎ عبر المجموعات:

inline fun <T, K> Iterable<T>.groupingBy(
    crossinline keySelector: (T) -> K
): Grouping<T, K>

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

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

كائن من النوع Grouping من المصفوفة أو المجموعة التي استُدعيت عبرها لاستخدامه لاحقًا مع عمليات المجموعات ( group-and-fold ).

أمثلة

استخدام الدالة `()groupingBy` مع المصفوفات

تعرف الشيفرة الآتية مصفوفة باسم array مكونة من ست سلاسل نصية باستخدام الدالة ()arrayOf، ثم تُنشئ منه كائنًا من النوع Grouping باسم grouping باستخدام الدالة ()groupingBy، وتمرّر إليها دالة تعيد الحرف الأول من السلسلة النصية، ثم تطبع القاموس map:

fun main(args: Array<String>) {
val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd")
    
val grouping = array.groupingBy { it.first()}.eachCount()
    
print(grouping) // {a=5, d=1}
}

انظر أيضًا

groupBy()‎: تعيد قاموسًا يُجمّع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة keySelector وقيمه لوائحُ تضم عناصر المصفوفة أو المجموعة (أو ناتج تمرير عناصر المصفوفة أو المجموعة على الدالة valueTransform في حال تمريرها).

groupByTo()‎: تجمّع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وتضيفها إلى القاموس.المُمرّر destination حيث مفاتيحه تعيدها الدالة الممرّرة keySelector()‎ مُطبّقة على كل عناصر المصفوفة أو المجموعة، وقيمُه لوائح تضم العناصر المقابلة، وفي حال تمرير معامل ثالث valueTransform فإنّ القيم ستكون لوائح تضم ناتج تطبيق الدالة valueTransform على العناصر المقابلة . ثم تعيد القاموسdestination.

مصادر

الدالة groupingBy()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>groupingBy()‎</code> في لغة Kotlin}}</noinclude>
-يخت
+تُنشئ الدالة<code>groupingBy()‎</code> كائنًا من النوع <code>Grouping</code> من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها لاستخدامه لاحقًا مع عمليات المجموعات (group-and-fold operations)، وذلك باستخدام الدالة المُمرّرة  <code>keySelector</code> لاستخلاص مفتاح من كل عنصر .
-تجمّع الدالة<code>groupingBy()‎</code> عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتضيفها إلى [[Kotlin/collections/Map|القاموس]].المُمرّر  <code>destination</code> حيث مفاتيحه تعيدها   الدالة الممرّرة <code>keySelector()‎</code>  مُطبّقة على كل عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]، وقيمُه [[Kotlin/collections/List|لوائح]] تضم العناصر المقابلة، وفي حال تمرير معامل ثالث <code>valueTransform</code> فإنّ القيم ستكون [[Kotlin/collections/List|لوائح]]  تضم ناتج تطبيق الدالة <code>valueTransform</code> على العناصر المقابلة . ثم تعيد القاموس<code>destination.</code>
 ==البنية العامة==
-<syntaxhighlight lang="kotlin">
+يمكن  استدعاء الدالة<code>groupByTo()‎</code> عبر  [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
-inline fun <T, K, M : MutableMap<in K, MutableList<T>>> Array<out T>.groupByTo(
+inline fun <T, K> Array<out T>.groupingBy(
-    destination: M,
+     crossinline keySelector: (T) -> K
-    keySelector: (T) -> K
+): Grouping<T, K>
-): M
+</syntaxhighlight>يمكن  استدعاء الدالة<code>groupByTo()‎</code> عبر  [[Kotlin/Array|المجموعات]]:<syntaxhighlight lang="kotlin">
-inline fun <K, M : MutableMap<in K, MutableList<Byte>>> ByteArray.groupByTo(
+inline fun <T, K> Iterable<T>.groupingBy(
-    destination: M,
+     crossinline keySelector: (T) -> K
-    keySelector: (Byte) -> K
+): Grouping<T, K>
-): M
+</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
-inline fun <K, M : MutableMap<in K, MutableList<Short>>> ShortArray.groupByTo(
-    destination: M,
-    keySelector: (Short) -> K
-): M
-inline fun <K, M : MutableMap<in K, MutableList<Int>>> IntArray.groupByTo(
-    destination: M,
-    keySelector: (Int) -> K
-): M
-inline fun <K, M : MutableMap<in K, MutableList<Long>>> LongArray.groupByTo(
-    destination: M,
-    keySelector: (Long) -> K
-): M
-inline fun <K, M : MutableMap<in K, MutableList<Float>>> FloatArray.groupByTo(
-    destination: M,
-    keySelector: (Float) -> K
-): M
-inline fun <K, M : MutableMap<in K, MutableList<Double>>> DoubleArray.groupByTo(
-    destination: M,
-    keySelector: (Double) -> K
-): M
-inline fun <K, M : MutableMap<in K, MutableList<Boolean>>> BooleanArray.groupByTo(
-    destination: M,
-    keySelector: (Boolean) -> K
-): M
-inline fun <K, M : MutableMap<in K, MutableList<Char>>> CharArray.groupByTo(
-    destination: M,
-    keySelector: (Char) -> K
-): M
-</syntaxhighlight>في حال استدعاء الدالة<code>groupByTo()‎</code> على [[Kotlin/Array|المصفوفات]] مع تمرير معاملين <code>destination</code> و<code>keySelector</code> فإنّها تُجمّع عناصر [[Kotlin/Array|المصفوفة]] الأصلية وتضيفها إلى [[Kotlin/collections/Map|القاموس]].المُمرّر  <code>destination</code> حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()‎</code>  مُطبّقة على كل عناصر [[Kotlin/Array|المصفوفة]] وقيمه [[Kotlin/collections/List|لوائح]] تضم العناصر المقابلة. ثم تعيد القاموس<code>destination.</code><syntaxhighlight lang="kotlin">
-inline fun <T, K, V, M : MutableMap<in K, MutableList<V>>> Array<out T>.groupByTo(
-     destination: M,
-    keySelector: (T) -> K,
-    valueTransform: (T) -> V
-): M
-inline fun <K, V, M : MutableMap<in K, MutableList<V>>> ByteArray.groupByTo(
-    destination: M,
-    keySelector: (Byte) -> K,
-    valueTransform: (Byte) -> V
-): M
-inline fun <K, V, M : MutableMap<in K, MutableList<V>>> ShortArray.groupByTo(
-    destination: M,
-    keySelector: (Short) -> K,
-    valueTransform: (Short) -> V
-): M
-inline fun <K, V, M : MutableMap<in K, MutableList<V>>> IntArray.groupByTo(
-    destination: M,
-    keySelector: (Int) -> K,
-    valueTransform: (Int) -> V
-): M
-inline fun <K, V, M : MutableMap<in K, MutableList<V>>> LongArray.groupByTo(
-    destination: M,
-    keySelector: (Long) -> K,
-    valueTransform: (Long) -> V
-): M
-inline fun <K, V, M : MutableMap<in K, MutableList<V>>> FloatArray.groupByTo(
-    destination: M,
-    keySelector: (Float) -> K,
-    valueTransform: (Float) -> V
-): M
-inline fun <K, V, M : MutableMap<in K, MutableList<V>>> DoubleArray.groupByTo(
-    destination: M,
-    keySelector: (Double) -> K,
-    valueTransform: (Double) -> V
-): M
-inline fun <K, V, M : MutableMap<in K, MutableList<V>>> BooleanArray.groupByTo(
-    destination: M,
-    keySelector: (Boolean) -> K,
-    valueTransform: (Boolean) -> V
-): M
-inline fun <K, V, M : MutableMap<in K, MutableList<V>>> CharArray.groupByTo(
-    destination: M,
-    keySelector: (Char) -> K,
-    valueTransform: (Char) -> V
-): M
-</syntaxhighlight>في حال استدعاء الدالة<code>groupByTo()‎</code> على [[Kotlin/Array|المصفوفات]] مع تمرير ثلاث معاملات <code>destination</code> و <code>valueTransform</code> و <code>keySelector</code> فإنّها تُجمّع العناصر المعادة من قبل الدالة  <code>valueTransform()‎</code> مُطبّقة على كل عناصر [[Kotlin/Array|المصفوفة]] وتربطها بالمفتاح الذي تعيده الدالة<code>keySelector()‎</code> مطبقة على على عناصر [[Kotlin/Array|المصفوفة]] وتضيفها إلى [[Kotlin/collections/Map|القاموس]] المُمرّر  <code>destination</code> حيث كل مفتاح مرتبط [[Kotlin/collections/List|بلائحة]] العناصر المقابلة. ثم تعيد [[Kotlin/collections/Map|القاموس]] <code>destination.</code><syntaxhighlight lang="kotlin">
-inline fun <T, K> Iterable<T>.groupBy(
-     keySelector: (T) -> K
-): Map<K, List<T>>
-</syntaxhighlight>في حال استدعاء الدالة<code>groupByTo()‎</code> على [[Kotlin/collections|المجموعات]] مع تمرير معاملين <code>destination</code> و<code>keySelector</code> فإنّها تُجمّع عناصر  [[Kotlin/collections|المجموعة]] الأصلية وتضيفها إلى [[Kotlin/collections/Map|القاموس]].المُمرّر  <code>destination</code> حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()‎</code>  مُطبّقة على كل عناصر  [[Kotlin/collections|المجموعة]] وقيمه [[Kotlin/collections/List|لوائح]] تضم العناصر المقابلة. ثم تعيد القاموس<code>destination.</code><syntaxhighlight lang="kotlin">
-inline fun <T, K, V> Iterable<T>.groupBy(
-    keySelector: (T) -> K,
-    valueTransform: (T) -> V
-): Map<K, List<V>>
-</syntaxhighlight>في حال استدعاء الدالة<code>groupByTo()‎</code> على [[Kotlin/collections|المجموعات]] مع تمرير ثلاث معاملات <code>destination</code> و <code>valueTransform</code> و <code>keySelector</code> فإنّها تُجمّع العناصر المعادة من قبل الدالة  <code>valueTransform()‎</code> مُطبّقة على كل عناصر  [[Kotlin/collections|المجموعة]] وتربطها بالمفتاح الذي تعيده الدالة<code>keySelector()‎</code> مطبقة على على عناصر  [[Kotlin/collections|المجموعة]] وتضيفها إلى [[Kotlin/collections/Map|القاموس]] المُمرّر  <code>destination</code> حيث كل مفتاح مرتبط [[Kotlin/collections/List|بلائحة]] العناصر المقابلة. ثم تعيد [[Kotlin/collections/Map|القاموس]] <code>destination</code>.
-يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المٌعادة==
-[[Kotlin/collections/Map|القاموس]] <code>destination</code> المُمرّر إلى الدالة<code>()groupByTo</code>.
+كائن من النوع <code>Grouping</code> من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها لاستخدامه لاحقًا مع عمليات المجموعات ( group-and-fold ).
 ==أمثلة==
-===استخدام الدالة <code>()groupByTo</code> مع المصفوفات مع تمرير معاملين===
+===استخدام الدالة <code>()groupingBy</code> مع المصفوفات===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ست [[Kotlin/collections/String|سلاسل نصية]] باستخدام الدالة <code>()arrayOf</code>، ثم تُنشئ  [[Kotlin/collections/Map|قاموسًا]] فارغًا باسم <code>map</code> باستخدام الدالة <code>()mutableMapOf</code>، ثم تستخدم الدالة <code>()groupByTo</code> على <code>array</code> بتمرير [[Kotlin/collections/Map|القاموس]] <code>map</code> و دالة تعيد طول [[Kotlin/collections/String|السلسلة النصية]] المُمرّرة، ثم تطبع [[Kotlin/collections/Map|القاموس]] <code>map</code>:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ست [[Kotlin/collections/String|سلاسل نصية]] باستخدام الدالة <code>()arrayOf</code>، ثم تُنشئ منه كائنًا من النوع <code>Grouping</code> باسم <code>grouping</code> باستخدام الدالة <code>()groupingBy</code>، وتمرّر إليها دالة تعيد الحرف الأول من [[Kotlin/collections/String|السلسلة النصية]]، ثم تطبع [[Kotlin/collections/Map|القاموس]] <code>map</code>:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
 val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd")
-val map: MutableMap<Int, MutableList<String>> = mutableMapOf()
-array.groupByTo ( map, { it.length })
+val grouping = array.groupingBy { it.first()}.eachCount()
-print(map) // {1=[a], 3=[abc, def], 2=[ab], 4=[avde, abcd]}
+print(grouping) // {a=5, d=1}
 }
 </syntaxhighlight>
-===استخدام الدالة <code>()groupingBy</code> مع المصفوفات مع تمرير ثلاث معاملات===
+===<nowiki/>انظر أيضًا===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ست [[Kotlin/collections/String|سلاسل نصية]] باستخدام الدالة <code>()arrayOf</code>، ثم تُنشئ  [[Kotlin/collections/Map|قاموسًا]] فارغًا باسم <code>map</code> باستخدام الدالة <code>()mutableMapOf</code>، ثم تستدعي الدالة <code>()groupingBy</code> على <code>array</code> بتمرير [[Kotlin/collections/Map|القاموس]] <code>map</code> و دالة تعيد طول [[Kotlin/collections/String|السلسلة النصية]] المُمرّرة ودالة تحوّل [[Kotlin/collections/String|السلاسل النصية]] إلى [[Kotlin/collections/String|سلاسل نصية]] ذات حروف كبيرة ، ثم تطبع [[Kotlin/collections/Map|القاموس]] <code>map</code>:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd")
-val map: MutableMap<Int, MutableList<String>> = mutableMapOf()
-array.groupByTo ( map, { it.length }, {it.toUpperCase()})
-print(map) // {1=[A], 3=[ABC, DEF], 2=[AB], 4=[AVDE, ABCD]}
-}
-</syntaxhighlight>
-==انظر أيضًا==
 <code>[[Kotlin/collections/groupByTo|groupBy()]]</code>‎: تعيد [[Kotlin/collections/Map|قاموسًا]] يُجمّع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] (أو ناتج تمرير عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] على الدالة <code>valueTransform</code> في حال تمريرها).
+<code>[[Kotlin/collections/groupByTo|groupByTo()]]</code>‎: تجمّع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتضيفها إلى القاموس.المُمرّر <code>destination</code> حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()‎</code> مُطبّقة على كل عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]]، وقيمُه لوائح تضم العناصر المقابلة، وفي حال تمرير معامل ثالث <code>valueTransform</code> فإنّ القيم ستكون لوائح تضم ناتج تطبيق الدالة <code>valueTransform</code> على العناصر المقابلة . ثم تعيد القاموس<code>destination.</code>
 ==مصادر==
-[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/group-by-to.html الدالة groupingBy()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin]
+[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/grouping-by.html الدالة groupingBy()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]