الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/groupBy»
< Kotlin | kotlin.text
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] (أو ناتج تمرير | تعيد الدالة<code>groupBy()</code> [[Kotlin/collections/Map|قاموسًا]] يُجمّع حروف [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] (أو ناتج تمرير عناصرها على الدالة <code>valueTransform</code> في حال تمريرها). | ||
القاموس المُعاد يحافظ على على ترتيب التكرار (entry iteration order) للمفاتيح الناتجة عن [[Kotlin/CharSequence/index|سلسلة الحروف]] الأصلية. | القاموس المُعاد يحافظ على على ترتيب التكرار (entry iteration order) للمفاتيح الناتجة عن [[Kotlin/CharSequence/index|سلسلة الحروف]] الأصلية. | ||
| سطر 8: | سطر 8: | ||
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>في حال استدعاء الدالة<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"> | ||
inline fun <K, V> CharSequence.groupBy( | inline fun <K, V> CharSequence.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|سلسلة | </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|بلائحة]] العناصر المقابلة. | ||
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | |||
==القيم المٌعادة== | ==القيم المٌعادة== | ||
[[Kotlin/collections/Map|قاموس]]. | [[Kotlin/collections/Map|قاموس]]. | ||
| سطر 44: | سطر 42: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
<code>[[Kotlin/ | <code>[[Kotlin/kotlin.text/groupByTo|groupByTo()]]</code>: تجمّع الدالة<code>groupByTo()</code> عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها وتضيفها إلى القاموس المُمرّر <code>destination</code> حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()</code> مُطبّقة على كل عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]]، وقيمُه لوائح تضم العناصر المقابلة، وفي حال تمرير معامل ثالث <code>valueTransform</code> فإنّ القيم ستكون لوائح تضم ناتج تطبيق الدالة <code>valueTransform</code> على العناصر المقابلة . ثم تعيد القاموس<code>destination.</code> | ||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/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]] | ||
مراجعة 18:13، 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 للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (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(): تجمّع الدالةgroupByTo() عناصر سلسلة الحروف التي استُدعيت عبرها وتضيفها إلى القاموس المُمرّر destination حيث مفاتيحه تعيدها الدالة الممرّرة keySelector() مُطبّقة على كل عناصر سلسلة الحروف، وقيمُه لوائح تضم العناصر المقابلة، وفي حال تمرير معامل ثالث valueTransform فإنّ القيم ستكون لوائح تضم ناتج تطبيق الدالة valueTransform على العناصر المقابلة . ثم تعيد القاموسdestination.