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

من موسوعة حسوب
التعديل اللاحق ←
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexed()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>mapIndexed()‎</code> Kotlin/collec...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexed()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexed()‎</code> في لغة Kotlin}}</noinclude>
   
   
تعيد الدالة<code>mapIndexed()‎</code> [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>mapIndexed()‎</code> على [[Kotlin/collections/Map|قاموس]] فستعيد [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries)  [[Kotlin/collections/Map|القاموس]].
تعيد الدالة<code>mapIndexed()‎</code> [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها وعلى فهارسها.


==البنية العامة==
==البنية العامة==
يمكن استدعاء الدالة<code>map()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
يمكن استدعاء الدالة<code>mapIndexed()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
inline fun <T, R> Array<out T>.map(
inline fun <T, R> Array<out T>.mapIndexed(
     transform: (T) -> R
     transform: (index: Int, T) -> R
): List<R>
inline fun <R> ByteArray.mapIndexed(
    transform: (index: Int, Byte) -> R
): List<R>  
): List<R>  
inline fun <R> ByteArray.map(transform: (Byte) -> R): List<R>
inline fun <R> ShortArray.mapIndexed(
inline fun <R> ShortArray.map(
     transform: (index: Int, Short) -> R
     transform: (Short) -> R
): List<R>  
): List<R>  
inline fun <R> IntArray.map(transform: (Int) -> R): List<R>
inline fun <R> IntArray.mapIndexed(
inline fun <R> LongArray.map(transform: (Long) -> R): List<R>
    transform: (index: Int, Int) -> R
inline fun <R> FloatArray.map(
    transform: (Float) -> R
): List<R>  
): List<R>  
inline fun <R> DoubleArray.map(
inline fun <R> LongArray.mapIndexed(
     transform: (Double) -> R
     transform: (index: Int, Long) -> R
): List<R>  
): List<R>  
inline fun <R> BooleanArray.map(
inline fun <R> FloatArray.mapIndexed(
     transform: (Boolean) -> R
    transform: (index: Int, Float) -> R
): List<R>
inline fun <R> DoubleArray.mapIndexed(
    transform: (index: Int, Double) -> R
): List<R>
inline fun <R> BooleanArray.mapIndexed(
     transform: (index: Int, Boolean) -> R
): List<R>
inline fun <R> CharArray.mapIndexed(
    transform: (index: Int, Char) -> R
): List<R>  
): List<R>  
inline fun <R> CharArray.map(transform: (Char) -> R): List<R>


</syntaxhighlight>يمكن استدعاء الدالة<code>map()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
</syntaxhighlight>يمكن استدعاء الدالة<code>mapIndexed()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
inline fun <T, R> Iterable<T>.map(
inline fun <T, R> Iterable<T>.mapIndexed(
     transform: (T) -> R
     transform: (index: Int, 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>
): List<R>
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
==القيم المٌعادة==
==القيم المٌعادة==
تعيد الدالة<code>mapIndexed()‎</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>()mapIndexed</code> مع القواميس===
===استخدام الدالة <code>()mapIndexed</code> مع المصفوفات===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Map|قاموسًا]] باسم <code>m</code>مكونًا من ثلاثة أزواج باستخدام الدالة <code>()mapOf</code>، ثم تُعرّف الدالة <code>()func</code>، ثم تستخدم الدالة <code>()mapIndexed</code> بتمرير <code>()func</code> كمعامل<nowiki/>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونًا من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()mapIndexed</code> على <code>array</code><nowiki/>، مع تمرير دالة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val m = mapOf("x" to 2, "y" to 6, "z" to 5)
val array = arrayOf(1, 2, 3, 4, 5, 6)
val func : (Int) -> Array<Int> = { arrayOf(it)}


println(m.map { (a, b) -> listOf(a) }) // [[x], [y], [z]]
array.mapIndexed{index, element  -> print("$element:$index ") }
    // 1:0 2:1 3:2 4:3 5:4 6:5
}
}
</syntaxhighlight>
</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|اللائحة]] المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] وفهارسها.
*<code>[[Kotlin/collections/map|map()]]</code>‎: تعيد [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>map()‎</code> على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries) <nowiki/>[[Kotlin/collections/Map|القاموس]].
==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map.html الدالة  mapIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-indexed.html الدالة  mapIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Functions]]

مراجعة 15:09، 29 مايو 2018


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

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

يمكن استدعاء الدالةmapIndexed()‎ على المصفوفات.

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

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

inline fun <T, R> Iterable<T>.mapIndexed(
    transform: (index: Int, T) -> R
): List<R>

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

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

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

أمثلة

استخدام الدالة ()mapIndexed مع المصفوفات

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونًا من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة  ()mapIndexed على array، مع تمرير دالة، ثم تطبع الناتج:

fun main(args: Array<String>) {
val array = arrayOf(1, 2, 3, 4, 5, 6)

array.mapIndexed{index, element  -> print("$element:$index ") }
    // 1:0 2:1 3:2 4:3 5:4 6:5 
}

انظر أيضًا

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

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/collections/mapIndexed&oldid=9498»