الدالة toMap() في لغة Kotlin
تعيد الدالة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()عبر قاموس فستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.