الفرق بين المراجعتين لصفحة: «Kotlin/collections/map»

مراجعة 06:22، 25 يوليو 2018

تعيد الدالة map()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها.

البنية العامة

يمكن استدعاء الدالة map()‎ مع المصفوفات والمجموعات والخرائط:

inline fun <T, R> Array<out T>.map(
    transform: (T) -> R
): List<R> 
inline fun <R> ByteArray.map(transform: (Byte) -> R): List<R> 
inline fun <R> ShortArray.map(
    transform: (Short) -> R
): List<R> 
inline fun <R> IntArray.map(transform: (Int) -> R): List<R> 
inline fun <R> LongArray.map(transform: (Long) -> R): List<R> 
inline fun <R> FloatArray.map(
    transform: (Float) -> R
): List<R> 
inline fun <R> DoubleArray.map(
    transform: (Double) -> R
): List<R> 
inline fun <R> BooleanArray.map(
    transform: (Boolean) -> R
): List<R> 
inline fun <R> CharArray.map(transform: (Char) -> R): List<R> 

inline fun <T, R> Iterable<T>.map(
    transform: (T) -> R
): List<R>

inline fun <K, V, R> Map<out K, V>.map(
    transform: (Entry<K, V>) -> R
): List<R>

وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)).

القيم المعادة

تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform()‎ المعطاة على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة المعطاة أيضًا.

أمثلة

تعرف الشيفرة الآتية خريطة باسم map1 باستخدام الدالة ()mapOf، ثم تستخدم الدالة ()map لجلب قيمة مفاتيح أزواج تلك الخريطة عبر تطبيق دالة معينة على كل زوج منها:

fun main(args: Array<String>) {
    val map1 = mapOf("x" to 2, "y" to 6, "z" to 5)
    val func: (Int) -> Array<Int> = { arrayOf(it)}

    println(map1.map { (a, b) -> listOf(a) }) // [[x], [y], [z]]
}

انظر أيضًا

الدالة mapIndexed()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها.

مصادر

صفحة الدالة map()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>map()‎</code> في لغة Kotlin}}</noinclude>
+تعيد الدالة <code>map()‎</code> [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها.
-تعيد الدالة<code>map()‎</code> [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>map()‎</code> على [[Kotlin/collections/Map|قاموس]] فستعيد [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries)  [[Kotlin/collections/Map|القاموس]].
 ==البنية العامة==
-يمكن استدعاء الدالة<code>map()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
+يمكن استدعاء الدالة <code>map()‎</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/collections|المجموعات]] والخرائط:<syntaxhighlight lang="kotlin">
 inline fun <T, R> Array<out T>.map(
      transform: (T) -> R
@@ سطر 25: / سطر 22: @@
 inline fun <R> CharArray.map(transform: (Char) -> R): List<R>
-</syntaxhighlight>يمكن استدعاء الدالة<code>map()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
 inline fun <T, R> Iterable<T>.map(
      transform: (T) -> R
 ): List<R>
-</syntaxhighlight>يمكن استدعاء الدالة<code>map()‎</code> على [[Kotlin/Map|القواميس]].<syntaxhighlight lang="kotlin">
 inline fun <K, V, R> Map<out K, V>.map(
      transform: (Entry<K, V>) -> R
 ): List<R>
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
-==القيم المٌعادة==
+==القيم المعادة==
-تعيد الدالة<code>map()‎</code> [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة المُمرّرة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>map()‎</code> على [[Kotlin/collections/Map|قاموس]] فستعيد [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries)  [[Kotlin/collections/Map|القاموس]].
+تُعاد [[Kotlin/collections/List|قائمةٌ]] تضم ناتج تطبيق الدالة <code>transform()‎</code> المعطاة على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة المعطاة أيضًا.
 ==أمثلة==
-===استخدام الدالة <code>()map</code> مع القواميس===
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Map|خريطة]] باسم <code>map1</code> باستخدام الدالة <code>()mapOf</code>، ثم تستخدم الدالة <code>()map</code> لجلب قيمة مفاتيح أزواج تلك الخريطة عبر تطبيق دالة معينة على كل زوج منها:<syntaxhighlight lang="kotlin">
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Map|قاموسًا]] باسم <code>m</code>مكونًا من ثلاثة أزواج باستخدام الدالة <code>()mapOf</code>، ثم تُعرّف الدالة <code>()func</code>، ثم تستخدم الدالة <code>()map</code> بتمرير <code>()func</code> كمعامل<nowiki/>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val m = mapOf("x" to 2, "y" to 6, "z" to 5)
+    val map1 = mapOf("x" to 2, "y" to 6, "z" to 5)
-val func : (Int) -> Array<Int> = { arrayOf(it)}
+    val func: (Int) -> Array<Int> = { arrayOf(it)}
-println(m.map { (a, b) -> listOf(a) }) // [[x], [y], [z]]
+    println(map1.map { (a, b) -> listOf(a) }) // [[x], [y], [z]]
 }
 </syntaxhighlight>
 ===انظر أيضًا===
-*<code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code>‎: تضيف إلى [[Kotlin/collections/List|اللائحة]] المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] وفهارسها.
+*الدالة <code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map.html الدالة  map()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map.html صفحة الدالة map()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>map()‎</code> في Kotlin}}</noinclude>
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]