عرض مصدر Kotlin/collections/toMap

<noinclude>{{DISPLAYTITLE: الدالة <code>toMap()‎</code> في Kotlin}}</noinclude>
تحول الدالة <code>toMap()‎</code> الكائن المستدعى معها إلى خريطة أو تضيف محتوى ذلك الكائن إلى خريطة موجودة مسبقًا.
==البنية العامة==
إن استدعيت الدالة <code>toMap()‎</code> مع [[Kotlin/Array|مصفوفة]] أو [[Kotlin/Iterable|مجموعة تكرارية]] أو [[Kotlin/Sequence|سلسلة]] مكونة من أزواج، فستعيد [[Kotlin/collections/Map|خريطة]] تحوي كل تلك الأزواج؛ تحافظ [[Kotlin/Map|الخريطة]] المُعادة على نفس ترتيب تكرار الخريطة الأصلية:<syntaxhighlight lang="kotlin">
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> 


</syntaxhighlight>وإن استدعيت الدالة <code>toMap()‎</code> مع [[Kotlin/Array|مصفوفة]] أو [[Kotlin/Iterable|مجموعة تكرارية]] أو [[Kotlin/Sequence|سلسلة]] مكونة من أزواج ومع تمرير [[Kotlin/collections/MutableMap|الخريطة المتغيرة]] <code>destination</code> كوسيط إليها، فستضيف تلك الأزواج إلى هذه الخريطة المعطاة ثم تعيدها:<syntaxhighlight lang="kotlin">
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
</syntaxhighlight>وإن استدعيت الدالة <code>toMap()‎</code> مع [[Kotlin/Map|خريطة]]، فستعيد [[Kotlin/collections/Map|خريطة]] جديدة للقراء فقط (read-only) تحوي جميع أزواج الخريطة الأصلية المعطاة؛ تحافظ [[Kotlin/Map|الخريطة]] المُعادة على نفس ترتيب تكرار الخريطة الأصلية:<syntaxhighlight lang="kotlin">
fun <K, V> Map<out K, V>.toMap(): Map<K, V> 

</syntaxhighlight>أمَّا إن استدعيت الدالة <code>toMap()‎</code> مع [[Kotlin/collections/Map|خريطة]] ومع تمرير [[Kotlin/collections/MutableMap|الخريطة المتغيرة]] <code>destination</code> كوسيط إليها، فستضيف أزواج تلك الخريطة الأصلية إلى الخريطة <code>destinations</code> المعطاة ثم تعيدها.<syntaxhighlight lang="kotlin">
fun <K, V, M : MutableMap<in K, in V>> Map<out K, V>.toMap(
    destination: M
): M
</syntaxhighlight>
==القيمة المعادة==
تُعاد خريطة جديدة تحوي جميع محتويات الكائن المعطى إن لم يمرَّر الوسيط <code>destinations</code>، أو يُعاد الوسيط <code>destination</code> بعد إضافة محتويات الكائن المعطى إليه.
==أمثلة==
<nowiki/>استعمال الدالة <code>()toMap</code> لتحويل مصفوفة مكونة من أزواج إلى خريطة:<syntaxhighlight lang="kotlin">
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}
    println(array.toMap().javaClass.kotlin.qualifiedName) // java.util.LinkedHashMap
}
</syntaxhighlight>
==انظر أيضًا==
* الدالة <code>[[Kotlin/collections/toBooleanArray|toBooleanArray()]]</code>‎: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<out Boolean>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من القيم المنطقية (من النوع <code>[[Kotlin/BooleanArray/index|BooleanArray]]</code>).
* الدالة <code>[[Kotlin/collections/toByteArray|toByteArray()]]</code>‎ : تحوِّل <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Byte>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>ByteArray</code>.
* الدالة <code>[[Kotlin/collections/toCharArray|toCharArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي التي من النوع <code>Array<Char>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/CharArray/index|CharArray]]</code>.
* الدالة <code>[[Kotlin/collections/toCollection|toCollection()‎]]</code>: تضيف جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها.
* الدالة <code>[[Kotlin/collections/toDoubleArray|toDoubleArray()]]</code>‎ : تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Double>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/DoubleArray/index|DoubleArray]]</code>.
* الدالة <code>[[Kotlin/collections/toFloatArray|toFloatArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Float>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت معها <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/FloatArray/index|FloatArray]]</code>.
* الدالة <code>[[Kotlin/collections/toHashSet|toHashSet()]]‎</code>: تعيد كائنًا من النوع <code>HashSet</code> لجميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها.
* الدالة <code>[[Kotlin/collections/toIntArray|toIntArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Int>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>IntArray</code>.
* الدالة <code>[[Kotlin/collections/toList|toList()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة.
* الدالة <code>[[Kotlin/collections/toLongArray|toLongArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Long>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>LongArray</code>.


*الدالة <code>[[Kotlin/collections/toMutableList|toMutableList()‎]]</code>: تحول [[Kotlin/Array|المصفوف]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى [[Kotlin/MutableList|قائمة متغيرة]]. 
*الدالة <code>[[Kotlin/collections/toMutableSet|toMutableSet()‎]]</code>: تحول [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها إلى مجموعة من النوع <code>MutableSet</code>.
*الدالة <code>[[Kotlin/collections/toSet|toSet()‎]]</code>: تحول [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها إلى مجموعة من النوع <code>[[Kotlin/Set|Set]]</code>.
*الدالة <code>[[Kotlin/collections/toShortArray|toShortArray()‎]]</code>: تحول [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Short>‎</code>) أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى [[Kotlin/Array|مصفوفة]] من النوع <code>ShortArray</code>.
*الدالة <code>[[Kotlin/collections/toSortedSet|toSortedSet()‎]]</code>: تحول [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها إلى مجموعة من النوع [[Kotlin/SortedSet|<code>SortedSet</code>]] ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة.

==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-map.html صفحة الدالة toMap()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]