الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/associateBy»
< Kotlin | kotlin.text
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.associateBy()</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>associateBy()</code> Kotlin/...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>text.associateBy()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>text.associateBy()</code> في لغة Kotlin}}</noinclude> | ||
تعيد | تعيد الدالة <code>associateBy()</code> <nowiki/>[[Kotlin/Map|قاموسًا]] (map) يحتوي عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>. | ||
إن كان لزوجين نفس المفتاح (key) فالأخير هو الذي سيُضاف إلى [[Kotlin/Map|القاموس]]. | إن كان لزوجين نفس المفتاح (key) فالأخير هو الذي سيُضاف إلى [[Kotlin/Map|القاموس]]. | ||
| سطر 7: | سطر 7: | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
inline fun <K | inline fun <K> CharSequence.associateBy( | ||
keySelector: (Char) -> K | |||
): Map<K, | ): Map<K, Char> | ||
</syntaxhighlight>يلاحظ وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]). | </syntaxhighlight>يلاحظ وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]). | ||
==القيم المعادة== | ==القيم المعادة== | ||
[[Kotlin/Map|قاموس]]. | [[Kotlin/Map|قاموس]]. | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()associateBy</code> === | ===استخدام الدالة <code>()associateBy</code> مع سلسلة نصية === | ||
تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تنشئ [[Kotlin/Map|قاموسًا]]<nowiki/>باسم <code>map</code> بتمرير الدالة <code>() | تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تنشئ [[Kotlin/Map|قاموسًا]]<nowiki/>باسم <code>map</code> بتمرير الدالة<code>()upper</code> (التي تحول الحروف إلى الحالة الكبيرة [UpperCase]) إلى<code>()associateBy</code> ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val str = "hsoub" | val str = "hsoub" | ||
val | val upper: (Char) -> Char = { | ||
it.toUpperCase() | |||
} | } | ||
val map = str. | val map = str.associateBy(upper) | ||
println(map) // {H= | println(map) // {H=h, S=s, O=o, U=u, B=b} | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 34: | سطر 34: | ||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/associate.html الدالة text.associateBy() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/associate-by.html الدالة text.associateBy() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 17:49، 7 يوليو 2018
تعيد الدالة associateBy() قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة keySelector.
إن كان لزوجين نفس المفتاح (key) فالأخير هو الذي سيُضاف إلى القاموس.
يحافظ القاموسالمُعاد على نفس ترتيب التكرار الخاص بسلسلة الحروف الأصليَّة.
البنية العامة
inline fun <K> CharSequence.associateBy(
keySelector: (Char) -> K
): Map<K, Char>
يلاحظ وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions)).
القيم المعادة
أمثلة
استخدام الدالة ()associateBy مع سلسلة نصية
تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تنشئ قاموسًاباسم map بتمرير الدالة()upper (التي تحول الحروف إلى الحالة الكبيرة [UpperCase]) إلى()associateBy ثم تطبع الناتج:
fun main(args: Array<String>) {
val str = "hsoub"
val upper: (Char) -> Char = {
it.toUpperCase()
}
val map = str.associateBy(upper)
println(map) // {H=h, S=s, O=o, U=u, B=b}
}
انظر أيضًا
append():تضم الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنفAppendable.
all(): تعيد الدالةall()القيمةtrueإن كانت كل الحروف تحقق الشرط المنطقي المُمرّرpredicate.
asSequence(): تنشئ كائنًا من الصنفSequenceوالذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.