الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/associate»
< Kotlin | kotlin.text
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 27: | سطر 27: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* <code>[[Kotlin/kotlin.text/associateBy|associateBy()]]</code>: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>. | |||
* <code>[[Kotlin/kotlin.text/append|append()]]</code>:تضم الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف <code>Appendable</code>. | * <code>[[Kotlin/kotlin.text/append|append()]]</code>:تضم الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف <code>Appendable</code>. | ||
مراجعة 18:16، 7 يوليو 2018
تعيد الدالة associate() قاموسًا (map) يحتوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر سلسلة الحروف التي استُدعيت عبرها.
إن كان لزوجين نفس المفتاح (key) فالأخير هو الذي سيُضاف إلى القاموس.
يحافظ القاموسالمُعاد على نفس ترتيب التكرار الخاص بسلسلة الحروف الأصليَّة.
البنية العامة
inline fun <K, V> CharSequence.associate(
transform: (Char) -> Pair<K, V>
): Map<K, V>
يلاحظ وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions)).
القيم المعادة
أمثلة
استخدام الدالة ()associate
تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تنشئ قاموسًاباسم map بتمرير الدالة ()toMap إلى ()associateالتي تحول تلك الحروف إلى زوج مكون من الحرف في الحالة الكبيرة [UpperCase] ومن قيمته العددية، ثمَّ تطبع الناتج:
fun main(args: Array<String>) {
val str = "hsoub"
val toMap: (Char) -> Pair<Char, Int> = {
Pair(it.toUpperCase(), it.toInt())
}
val map = str.associate(toMap)
println(map) // {H=104, S=115, O=111, U=117, B=98}
}
انظر أيضًا
associateBy(): تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالةkeySelector.append():تضم الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنفAppendable.
all(): تعيد الدالةall()القيمةtrueإن كانت كل الحروف تحقق الشرط المنطقي المُمرّرpredicate.
asSequence(): تنشئ كائنًا من الصنفSequenceوالذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.