الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/groupBy»

من موسوعة حسوب
التعديل اللاحق ←
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.groupBy()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>groupBy()‎</code> Kotlin/collectio...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.groupBy()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>text.groupBy()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة<code>groupBy()‎</code> [[Kotlin/collections/Map|قاموسًا]] يُجمّع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] (أو ناتج تمرير عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] على الدالة <code>valueTransform</code> في حال تمريرها).
تعيد الدالة<code>groupBy()‎</code> [[Kotlin/collections/Map|قاموسًا]] يُجمّع حروف  [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر  [[Kotlin/CharSequence/index|سلسلة الحروف]] (أو ناتج تمرير عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] على الدالة <code>valueTransform</code> في حال تمريرها).


القاموس المُعاد يحافظ على على ترتيب التكرار (entry iteration order) للمفاتيح الناتجة عن [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] الأصلية.
القاموس المُعاد يحافظ على على ترتيب التكرار (entry iteration order) للمفاتيح الناتجة عن [[Kotlin/CharSequence/index|سلسلة الحروف]] الأصلية.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline fun <T, K> Array<out T>.groupBy(
inline fun <K> CharSequence.groupBy(
    keySelector: (T) -> K
): Map<K, List<T>>
inline fun <K> ByteArray.groupBy(
    keySelector: (Byte) -> K
): Map<K, List<Byte>>
inline fun <K> ShortArray.groupBy(
    keySelector: (Short) -> K
): Map<K, List<Short>>
inline fun <K> IntArray.groupBy(
    keySelector: (Int) -> K
): Map<K, List<Int>>
inline fun <K> LongArray.groupBy(
    keySelector: (Long) -> K
): Map<K, List<Long>>
inline fun <K> FloatArray.groupBy(
    keySelector: (Float) -> K
): Map<K, List<Float>>
inline fun <K> DoubleArray.groupBy(
    keySelector: (Double) -> K
): Map<K, List<Double>>
inline fun <K> BooleanArray.groupBy(
    keySelector: (Boolean) -> K
): Map<K, List<Boolean>>
inline fun <K> CharArray.groupBy(
     keySelector: (Char) -> K
     keySelector: (Char) -> K
): Map<K, List<Char>>  
): Map<K, List<Char>>
 
</syntaxhighlight>في حال استدعاء الدالة<code>groupBy()‎</code> على <nowiki/>[[Kotlin/CharSequence/index|سلسلة حروف]] مع تمرير معامل واحد <code>keySelector</code> فإنّها تُجمّع عناصر  <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] الأصلية في <nowiki/>[[Kotlin/collections/Map|قاموس]]. حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()‎</code> مُطبّقة على كل عناصر  <nowiki/>[[Kotlin/CharSequence/index|سلسلة حروف]] وقيمه لوائح تضم العناصر المقابلة.<syntaxhighlight lang="kotlin">
</syntaxhighlight>في حال استدعاء الدالة<code>groupBy()‎</code> على [[Kotlin/Array|المصفوفات]] مع تمرير معامل واحد <code>keySelector</code> فإنّها تُجمّع عناصر [[Kotlin/Array|المصفوفة]] الأصلية في [[Kotlin/collections/Map|قاموس]].حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()‎</code> مُطبّقة على كل عناصر [[Kotlin/Array|المصفوفة]] وقيمه [[Kotlin/collections/List|لوائح]] تضم العناصر المقابلة.<syntaxhighlight lang="kotlin">
inline fun <K, V> CharSequence.groupBy(
inline fun <T, K, V> Array<out T>.groupBy(
    keySelector: (T) -> K,
    valueTransform: (T) -> V
): Map<K, List<V>>
inline fun <K, V> ByteArray.groupBy(
    keySelector: (Byte) -> K,
    valueTransform: (Byte) -> V
): Map<K, List<V>>
inline fun <K, V> ShortArray.groupBy(
    keySelector: (Short) -> K,
    valueTransform: (Short) -> V
): Map<K, List<V>>
inline fun <K, V> IntArray.groupBy(
    keySelector: (Int) -> K,
    valueTransform: (Int) -> V
): Map<K, List<V>>
inline fun <K, V> LongArray.groupBy(
    keySelector: (Long) -> K,
    valueTransform: (Long) -> V
): Map<K, List<V>>
inline fun <K, V> FloatArray.groupBy(
    keySelector: (Float) -> K,
    valueTransform: (Float) -> V
): Map<K, List<V>>
inline fun <K, V> DoubleArray.groupBy(
    keySelector: (Double) -> K,
    valueTransform: (Double) -> V
): Map<K, List<V>>
inline fun <K, V> BooleanArray.groupBy(
    keySelector: (Boolean) -> K,
    valueTransform: (Boolean) -> V
): Map<K, List<V>>  
inline fun <K, V> CharArray.groupBy(
     keySelector: (Char) -> K,  
     keySelector: (Char) -> K,  
     valueTransform: (Char) -> V
     valueTransform: (Char) -> V
): Map<K, List<V>>  
): Map<K, List<V>>
 
</syntaxhighlight>في حال استدعاء الدالة<code>groupBy()‎</code> على [[Kotlin/CharSequence/index|سلسلة الحروف]] مع تمرير معاملين <code>valueTransform</code> و <code>keySelector</code> فإنّها تُجمّع العناصر المعادة من قبل الدالة  <code>valueTransform()‎</code> مُطبّقة على كل عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] وتربطها بالمفتاح الذي تعيده الدالة<code>keySelector()‎</code> مطبقة على على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] وتعيد [[Kotlin/collections/Map|قاموسًا]] حيث كل مفتاح مرتبط [[Kotlin/collections/List|بلائحة]] العناصر المقابلة.<syntaxhighlight lang="kotlin">
</syntaxhighlight>في حال استدعاء الدالة<code>groupBy()‎</code> على [[Kotlin/Array|المصفوفات]] مع تمرير معاملين <code>valueTransform</code> و <code>keySelector</code> فإنّها تُجمّع العناصر المعادة من قبل الدالة  <code>valueTransform()‎</code> مُطبّقة على كل عناصر [[Kotlin/Array|المصفوفة]] وتربطها بالمفتاح الذي تعيده الدالة<code>keySelector()‎</code> مطبقة على على عناصر [[Kotlin/Array|المصفوفة]] وتعيد [[Kotlin/collections/Map|قاموسًا]] حيث كل مفتاح مرتبط [[Kotlin/collections/List|بلائحة]] العناصر المقابلة.<syntaxhighlight lang="kotlin">
inline fun <T, K> Iterable<T>.groupBy(
inline fun <T, K> Iterable<T>.groupBy(
     keySelector: (T) -> K
     keySelector: (T) -> K
): Map<K, List<T>>
): Map<K, List<T>>
</syntaxhighlight>في حال استدعاء الدالة<code>groupBy()‎</code> على [[Kotlin/collections|المجموعات]] مع تمرير معامل واحد <code>keySelector</code> فإنّها تُجمّع عناصر  [[Kotlin/collections|المجموعة]] الأصلية في [[Kotlin/collections/Map|قاموس]].حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()‎</code>  مُطبّقة على كل عناصر  [[Kotlin/collections|المجموعة]] وقيمه [[Kotlin/collections/List|لائحة]] تضم العناصر المقابلة.<syntaxhighlight lang="kotlin">
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
inline fun <T, K, V> Iterable<T>.groupBy(
    keySelector: (T) -> K,
    valueTransform: (T) -> V
): Map<K, List<V>>
</syntaxhighlight>في حال استدعاء الدالة<code>groupBy()‎</code> على [[Kotlin/collections|المجموعات]] مع تمرير معاملين <code>valueTransform</code> و <code>keySelector</code> فإنّها تُجمّع العناصر المعادة من قبل الدالة  <code>valueTransform()‎</code> مُطبّقة على كل عناصر [[Kotlin/Array|المجموعة]] وتربطها بالمفتاح الذي تعيده الدالة<code>keySelector()‎</code> مطبقة على على عناصر [[Kotlin/Array|المجموعة]] وتعيد [[Kotlin/collections/Map|قاموسًا]] حيث كل مفتاح مرتبط [[Kotlin/collections/List|بلائحة]] العناصر المقابلة.
 
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
==القيم المٌعادة==
==القيم المٌعادة==
[[Kotlin/collections/Map|قاموس]] يُجمّع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] (أو ناتج تمرير عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] على الدالة <code>valueTransform</code> في حال تمريرها).
[[Kotlin/collections/Map|قاموس]].
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()groupBy</code> مع المصفوفات مع تمرير معامل واحد===
===استخدام الدالة <code>()groupBy</code> مع السلاسل النصية مع تمرير معامل واحد===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ست [[Kotlin/collections/String|سلاسل نصية]] باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()groupBy</code> على <code>array</code> بتمرير الدالة التي تعيد طول [[Kotlin/collections/String|السلسلة النصية]] المُمرّرة، وتجمّع عناصر <code>array</code> التي لها نفس الطول في [[Kotlin/collections/Map|قاموس]]، ثم تطبع [[Kotlin/collections/Map|القاموس]]:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()groupBy</code> عبرها مع تمرير دالة كوسيط، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
    val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd")
val str = "abcdsafddssfghjjffhgggfeeregtgggfgddghhgfdqdgdg"


    print(array.groupBy { it.length } ) // {1=[a], 3=[abc, def], 2=[ab], 4=[avde, abcd]}
print(str.groupBy { it.toByte() } )  
}
}
</syntaxhighlight>المُخرجات<syntaxhighlight lang="kotlin">
{97=[a, a], 98=[b], 99=[c], 100=[d, d, d, d, d, d, d, d], 115=[s, s, s], 102=[f, f, f, f, f, f, f], 103=[g, g, g, g, g, g, g, g, g, g, g, g, g], 104=[h, h, h, h], 106=[j, j], 101=[e, e, e], 114=[r], 116=[t], 113=[q]}
</syntaxhighlight>
</syntaxhighlight>
===استخدام الدالة <code>()groupBy</code> مع المصفوفات مع تمرير مُعاملين===
===استخدام الدالة <code>()groupBy</code> مع سلسلة نصية مع تمرير مُعاملين===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ست [[Kotlin/collections/String|سلاسل نصية]] باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()groupBy</code> على <code>array</code> بتمرير دالة تعيد طول [[Kotlin/collections/String|السلسلة النصية]] المُمرّرة ودالة تعيد المصفوفة بالحروف الكبيرة، وتجمّع عناصر <code>array</code> التي لها نفس الطول في [[Kotlin/collections/Map|قاموس]] بتحويلها إلى الحروف الكبيرة، ثم تطبع [[Kotlin/collections/Map|القاموس]]:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()groupBy</code> عبرها مع تمرير دالتين كوسيطين، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
    val array = arrayOf("a", "abc", "ab", "def","avde" ,"abcd")
val str = "abcdsafddssfghjjffhgggfeeregtgggfgddghhgfdqdgdg"


    print(array.groupBy( { it.length }, {it.toUpperCase()} )) // {1=[A], 3=[ABC, DEF], 2=[AB],
print(str.groupBy ({ it.toByte() } , {it.toUpperCase()}) )
                                                              // 4=[AVDE, ABCD]}
}
}
</syntaxhighlight>المُخرجات:<syntaxhighlight lang="kotlin">
{97=[A, A], 98=[B], 99=[C], 100=[D, D, D, D, D, D, D, D], 115=[S, S, S], 102=[F, F, F, F, F, F, F], 103=[G, G, G, G, G, G, G, G, G, G, G, G, G], 104=[H, H, H, H], 106=[J, J], 101=[E, E, E], 114=[R], 116=[T], 113=[Q]}
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا==
==انظر أيضًا==
<code>[[Kotlin/collections/groupByTo|groupByTo()]]</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>‎: تضيف إلى [[Kotlin/collections/Map|القاموس]] المُمرّر  عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] (أو ناتج تمرير عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] على الدالة <code>valueTransform</code> في حال تمريرها). 
==مصادر==
==مصادر==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/group-by.html الدالة text.groupBy()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin]
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/group-by.html الدالة text.groupBy()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Functions]]

مراجعة 17:56، 9 يوليو 2018

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

القاموس المُعاد يحافظ على على ترتيب التكرار (entry iteration order) للمفاتيح الناتجة عن سلسلة الحروف الأصلية.

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

inline fun <K> CharSequence.groupBy(
    keySelector: (Char) -> K
): Map<K, List<Char>>

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

inline fun <K, V> CharSequence.groupBy(
    keySelector: (Char) -> K, 
    valueTransform: (Char) -> V
): Map<K, List<V>>

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

inline fun <T, K> Iterable<T>.groupBy(
    keySelector: (T) -> K
): Map<K, List<T>>

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

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

قاموس.

أمثلة

استخدام الدالة ()groupBy مع السلاسل النصية مع تمرير معامل واحد

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()groupBy عبرها مع تمرير دالة كوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
val str = "abcdsafddssfghjjffhgggfeeregtgggfgddghhgfdqdgdg"

print(str.groupBy { it.toByte() } ) 
}

المُخرجات

{97=[a, a], 98=[b], 99=[c], 100=[d, d, d, d, d, d, d, d], 115=[s, s, s], 102=[f, f, f, f, f, f, f], 103=[g, g, g, g, g, g, g, g, g, g, g, g, g], 104=[h, h, h, h], 106=[j, j], 101=[e, e, e], 114=[r], 116=[t], 113=[q]}

استخدام الدالة ()groupBy مع سلسلة نصية مع تمرير مُعاملين

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()groupBy عبرها مع تمرير دالتين كوسيطين، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
val str = "abcdsafddssfghjjffhgggfeeregtgggfgddghhgfdqdgdg"

print(str.groupBy ({ it.toByte() } , {it.toUpperCase()}) )
}

المُخرجات:

{97=[A, A], 98=[B], 99=[C], 100=[D, D, D, D, D, D, D, D], 115=[S, S, S], 102=[F, F, F, F, F, F, F], 103=[G, G, G, G, G, G, G, G, G, G, G, G, G], 104=[H, H, H, H], 106=[J, J], 101=[E, E, E], 114=[R], 116=[T], 113=[Q]}

انظر أيضًا

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

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/groupBy&oldid=12583»