الفرق بين المراجعتين ل"Kotlin/collections/map"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>map()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>map()‎</code> Kotlin/collections/List|ل...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>map()‎</code> في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>map()‎</code> في لغة Kotlin}}</noinclude>
 
   
 
   
−
تعيد الدالة<code>map()‎</code> [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>flatMap()‎</code> على [[Kotlin/collections/Map|قاموس]] فستعيد [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries)  [[Kotlin/collections/Map|القاموس]].
+
تعيد الدالة<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>flatMap()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
+
يمكن استدعاء الدالة<code>map()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
−
inline fun <T, R> Array<out T>.flatMap(
+
inline fun <T, R> Array<out T>.map(
−
     transform: (T) -> Iterable<R>
+
     transform: (T) -> R
 
): List<R>  
 
): List<R>  
−
inline fun <R> ByteArray.flatMap(
+
inline fun <R> ByteArray.map(transform: (Byte) -> R): List<R>
−
    transform: (Byte) -> Iterable<R>
+
inline fun <R> ShortArray.map(
 +
    transform: (Short) -> R
 
): List<R>  
 
): List<R>  
−
inline fun <R> ShortArray.flatMap(
+
inline fun <R> IntArray.map(transform: (Int) -> R): List<R>
−
    transform: (Short) -> Iterable<R>
+
inline fun <R> LongArray.map(transform: (Long) -> R): List<R>  
 +
inline fun <R> FloatArray.map(
 +
    transform: (Float) -> R
 
): List<R>  
 
): List<R>  
−
inline fun <R> IntArray.flatMap(
+
inline fun <R> DoubleArray.map(
−
     transform: (Int) -> Iterable<R>
+
     transform: (Double) -> R
 
): List<R>  
 
): List<R>  
−
inline fun <R> LongArray.flatMap(
+
inline fun <R> BooleanArray.map(
−
    transform: (Long) -> Iterable<R>
+
     transform: (Boolean) -> R
−
): List<R>
 
−
inline fun <R> FloatArray.flatMap(
 
−
    transform: (Float) -> Iterable<R>
 
−
): List<R>
 
−
inline fun <R> DoubleArray.flatMap(
 
−
    transform: (Double) -> Iterable<R>
 
−
): List<R>
 
−
inline fun <R> BooleanArray.flatMap(
 
−
     transform: (Boolean) -> Iterable<R>
 
−
): List<R>
 
−
inline fun <R> CharArray.flatMap(
 
−
    transform: (Char) -> Iterable<R>
 
 
): List<R>  
 
): List<R>  
 +
inline fun <R> CharArray.map(transform: (Char) -> R): List<R>
  
−
</syntaxhighlight>يمكن استدعاء الدالة<code>flatMap()‎</code> على [[Kotlin/Array|المجموعات]].<syntaxhighlight lang="kotlin">
+
</syntaxhighlight>يمكن استدعاء الدالة<code>map()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
−
inline fun <T, R> Iterable<T>.flatMap(
+
inline fun <T, R> Iterable<T>.map(
−
     transform: (T) -> Iterable<R>
+
     transform: (T) -> R
 
): List<R>
 
): List<R>
−
</syntaxhighlight>يمكن استدعاء الدالة<code>flatMap()‎</code> على [[Kotlin/Array|القواميس]].<syntaxhighlight lang="kotlin">
+
</syntaxhighlight>يمكن استدعاء الدالة<code>map()‎</code> على [[Kotlin/Map|القواميس]].<syntaxhighlight lang="kotlin">
−
inline fun <K, V, R> Map<out K, V>.flatMap(
+
inline fun <K, V, R> Map<out K, V>.map(
−
     transform: (Entry<K, V>) -> Iterable<R>
+
     transform: (Entry<K, V>) -> R
 
): List<R>
 
): List<R>
 
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
==القيم المٌعادة==
 
==القيم المٌعادة==
−
[[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>flatMap()‎</code> على [[Kotlin/collections/Map|قاموس]] فستعيد [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries)  [[Kotlin/collections/Map|القاموس]].
+
تعيد الدالة<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> مع القواميس===
 
===استخدام الدالة <code>()map</code> مع القواميس===
−
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|قاموسًا]] باسم <code>map</code>مكونة من ثلاثة أزواج باستخدام الدالة <code>()mapOf</code>، ثم تُعرّف الدالة <code>()func</code>، ثم تستخدم الدالة <code>()map</code> لإنشاء لائحة تحتوي ناتج تطبيق الدالة <code>()func</code> على مداخل<nowiki/>[[Kotlin/Array|القاموس]] <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>) {
 
fun main(args: Array<String>) {
−
val map = mapOf("x" to 2, "y" to 6, "z" to 5)
+
val m = 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(map.flatMap { (a, b) -> listOf(a) }) // [x, y, z]
+
println(m.map { (a, b) -> listOf(a) }) // [[x], [y], [z]]
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
===انظر أيضًا===
 
===انظر أيضًا===
−
*<code>[[Kotlin/collections/first|flatMapTo()]]</code>‎: تضيف إلى [[Kotlin/collections/List|اللائحة]] المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]].
+
*<code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code>‎: تضيف إلى [[Kotlin/collections/List|اللائحة]] المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] وفهارسها.
 
==مصادر==
 
==مصادر==
−
<span> </span>
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map.html الدالة  map()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
−
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/flat-map.html الدالة  map()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
−
 
 
−
*
 
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

مراجعة 14:53، 29 مايو 2018


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

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

يمكن استدعاء الدالة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>

يمكن استدعاء الدالةmap()‎ على المجموعات.

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

يمكن استدعاء الدالةmap()‎ على القواميس.

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

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

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

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

أمثلة

استخدام الدالة ()map مع القواميس

تعرف الشيفرة الآتية قاموسًا باسم mمكونًا من ثلاثة أزواج باستخدام الدالة ()mapOf، ثم تُعرّف الدالة ()func، ثم تستخدم الدالة ()map بتمرير ()func كمعامل، ثم تطبع الناتج:

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

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

انظر أيضًا

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/collections/map&oldid=9479"