الفرق بين المراجعتين لصفحة: «Kotlin/collections/toMap»
< Kotlin | collections
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
تعيد الدالة<code>toMap()</code> [[Kotlin/Map|قاموسًا]] بحسب نوع إمضاء الدالة (انظر فقرة ا<nowiki/>[[Kotlin/collections/toMap#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|لبنية العامة]] من أجل التفاصيل). | |||
تعيد الدالة<code>toMap()</code> [[Kotlin/Map|قاموسًا]] بحسب نوع إمضاء الدالة (انظر فقرة | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 8: | سطر 7: | ||
</syntaxhighlight>في حال استدعاء الدالة <code>toMap()</code> عبر [[Kotlin/Array|مصفوفة]] أو [[Kotlin/Iterable|مجموعة تكرارية]] أو [[Kotlin/Sequence|سلسلة]] مكونة من أزواج فستعيد [[Kotlin/Map|قاموسًا]] يضم كل تلك الأزواج، [[Kotlin/Map|القاموس]] يحافظ على ترتيب التكرار الأصلي. <syntaxhighlight lang="kotlin"> | </syntaxhighlight>في حال استدعاء الدالة <code>toMap()</code> عبر [[Kotlin/Array|مصفوفة]] أو [[Kotlin/Iterable|مجموعة تكرارية]] أو [[Kotlin/Sequence|سلسلة]] مكونة من أزواج فستعيد [[Kotlin/Map|قاموسًا]] يضم كل تلك الأزواج، [[Kotlin/Map|القاموس]] المُعاد يحافظ على ترتيب التكرار الأصلي.<syntaxhighlight lang="kotlin"> | ||
fun <K, V, M : MutableMap<in K, in V>> Iterable<Pair<K, V>>.toMap( | fun <K, V, M : MutableMap<in K, in V>> Iterable<Pair<K, V>>.toMap( | ||
destination: M | destination: M | ||
| سطر 23: | سطر 22: | ||
</syntaxhighlight>في حال استدعاء الدالة <code>toMap()</code> عبر [[Kotlin/Map|قاموس]] فستعيد [[Kotlin/Map|قاموسًا]] للقراء فقط (read-only) يضم كل الأزواج الموجودة في [[Kotlin/Map|القاموس]]. | </syntaxhighlight>في حال استدعاء الدالة <code>toMap()</code> عبر [[Kotlin/Map|قاموس]] فستعيد [[Kotlin/Map|قاموسًا]] للقراء فقط (read-only) يضم كل الأزواج الموجودة في [[Kotlin/Map|القاموس]]. | ||
[[Kotlin/Map|القاموس]] يحافظ على ترتيب التكرار الأصلي. <syntaxhighlight lang="kotlin"> | [[Kotlin/Map|القاموس]] المُعاد يحافظ على ترتيب التكرار الأصلي.<syntaxhighlight lang="kotlin"> | ||
fun <K, V, M : MutableMap<in K, in V>> Map<out K, V>.toMap( | fun <K, V, M : MutableMap<in K, in V>> Map<out K, V>.toMap( | ||
destination: M | destination: M | ||
): M | ): M | ||
</syntaxhighlight>في حال استدعاء الدالة <code>toMap()</code> عبر [[Kotlin/Map|قاموس]] مع تمرير [[Kotlin/MutableMap|قاموس متغير]] كوسيط فستملأ [[Kotlin/Map|القاموس]] المُمرّر بالأزواج الموجودة في [[Kotlin/Map|القاموس]]. | </syntaxhighlight>في حال استدعاء الدالة <code>toMap()</code> عبر [[Kotlin/Map|قاموس]] مع تمرير [[Kotlin/MutableMap|قاموس متغير]] كوسيط فستملأ [[Kotlin/Map|القاموس]] المُمرّر بالأزواج الموجودة في [[Kotlin/Map|القاموس]]. | ||
==القيمة المُعادة== | ==القيمة المُعادة== | ||
[[Kotlin/Map|قاموس]] جديد. (انظر فقرة البنية العامة لأجل التفاصيل) | [[Kotlin/Map|قاموس]] جديد. (انظر فقرة [[Kotlin/collections/toMap#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]] لأجل التفاصيل) | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()toMap</code> مع المصفوفات=== | ===استخدام الدالة <code>()toMap</code> مع المصفوفات=== | ||
| سطر 46: | سطر 44: | ||
*<code>[[Kotlin/collections/toList|toList()]]</code> : تعيد لائحة تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها. وفي حال استدعاء الدالة <code>toList()</code> عبر قاموس فستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه. | *<code>[[Kotlin/collections/toList|toList()]]</code> : تعيد لائحة تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها. وفي حال استدعاء الدالة <code>toList()</code> عبر قاموس فستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه. | ||
==مصادر== | ==مصادر== | ||
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-map.html الدالة toMap() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-map.html الدالة toMap() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 09:23، 24 يونيو 2018
تعيد الدالةtoMap() قاموسًا بحسب نوع إمضاء الدالة (انظر فقرة البنية العامة من أجل التفاصيل).
البنية العامة
fun <K, V> Iterable<Pair<K, V>>.toMap(): Map<K, V>
fun <K, V> Array<out Pair<K, V>>.toMap(): Map<K, V>
fun <K, V> Sequence<Pair<K, V>>.toMap(): Map<K, V>
في حال استدعاء الدالة toMap() عبر مصفوفة أو مجموعة تكرارية أو سلسلة مكونة من أزواج فستعيد قاموسًا يضم كل تلك الأزواج، القاموس المُعاد يحافظ على ترتيب التكرار الأصلي.
fun <K, V, M : MutableMap<in K, in V>> Iterable<Pair<K, V>>.toMap(
destination: M
): M
fun <K, V, M : MutableMap<in K, in V>> Array<out Pair<K, V>>.toMap(
destination: M
): M
fun <K, V, M : MutableMap<in K, in V>> Sequence<Pair<K, V>>.toMap(
destination: M
): M
في حال استدعاء الدالة toMap() عبر مصفوفة أو مجموعة تكرارية أو سلسلة مكونة من أزواج مع تمرير قاموس متغير كوسيط فستملأ القاموس المُمرّر بتلك الأزواج.
fun <K, V> Map<out K, V>.toMap(): Map<K, V>
في حال استدعاء الدالة toMap() عبر قاموس فستعيد قاموسًا للقراء فقط (read-only) يضم كل الأزواج الموجودة في القاموس.
القاموس المُعاد يحافظ على ترتيب التكرار الأصلي.
fun <K, V, M : MutableMap<in K, in V>> Map<out K, V>.toMap(
destination: M
): M
في حال استدعاء الدالة toMap() عبر قاموس مع تمرير قاموس متغير كوسيط فستملأ القاموس المُمرّر بالأزواج الموجودة في القاموس.
القيمة المُعادة
قاموس جديد. (انظر فقرة البنية العامة لأجل التفاصيل)
أمثلة
استخدام الدالة ()toMap مع المصفوفات
تعرّف الشيفرة الآتية مصفوفة باسم array مكونة من ثلاثة أزواج باستخدام الدالة ()arrayOf، ثم تستخدم الدالة()toMap على array، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(Pair(1, "x"), Pair(2, "y"), Pair(3, "z"))
println(array.toMap()) // {1=x, 2=y, 3=z}
}
أنظر أيضًا
toBooleanArray() : تعيد مصفوفة من القيم المنطقية (من النوعBooleanArray) تضم جميع عناصر المصفوفة العامة (أي من النوعArray<out Boolean>) أو المجموعة التي استُدعيت عبرها.toByteArray() : تعيد مصفوفة من النوعByteArrayتضم جميع عناصر المصفوفة العامة (أي من النوعArray<Byte>) أو المجموعة التي استُدعيت عبرها.toDoubleArray() : تعيد مصفوفة من النوعDoubleArrayتضم جميع عناصر المصفوفة العامة (أي من النوعArray<Double>) أو المجموعة التي استُدعيت عبرها.toList() : تعيد لائحة تضم جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها. وفي حال استدعاء الدالةtoList()عبر قاموس فستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.