الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/groupBy»
ط استبدال النص - '==القيم المٌعادة==' ب'==القيم المعادة==' |
ط استبدال النص - 'Kotlin Functions' ب'Kotlin Function' |
||
سطر 48: | سطر 48: | ||
*[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 | [[تصنيف:Kotlin Function]] |
مراجعة 11:37، 30 أغسطس 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.
groupingBy()
: تُنشئ كائنًا من النوعGrouping
من سلسلة الحروف التي استُدعيت عبرها لاستخدامه لاحقًا مع عمليات المجموعات (group-and-fold operations)، وذلك باستخدام الدالة المُمرّرةkeySelector
لاستخلاص مفتاح من كل عنصر .