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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexed()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>mapIndexed()‎</code> Kotlin/collec...'
 
طلا ملخص تعديل
 
(6 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexed()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexed()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>mapIndexed()‎</code> [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
تعيد الدالة<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>map()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
يمكن استدعاء الدالة <code>mapIndexed()‎</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/collections|المجموعات]]:<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>
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>  
): List<R>  
inline fun <R> ByteArray.map(transform: (Byte) -> R): List<R>
inline fun <R> FloatArray.mapIndexed(
inline fun <R> ShortArray.map(
     transform: (index: Int, Float) -> R
     transform: (Short) -> R
): List<R>  
): List<R>  
inline fun <R> IntArray.map(transform: (Int) -> R): List<R>
inline fun <R> DoubleArray.mapIndexed(
inline fun <R> LongArray.map(transform: (Long) -> R): List<R>
    transform: (index: Int, Double) -> R
inline fun <R> FloatArray.map(
    transform: (Float) -> R
): List<R>  
): List<R>  
inline fun <R> DoubleArray.map(
inline fun <R> BooleanArray.mapIndexed(
     transform: (Double) -> R
     transform: (index: Int, Boolean) -> R
): List<R>  
): List<R>  
inline fun <R> BooleanArray.map(
inline fun <R> CharArray.mapIndexed(
     transform: (Boolean) -> R
     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">
inline fun <T, R> Iterable<T>.mapIndexed(
inline fun <T, R> Iterable<T>.map(
     transform: (index: Int, T) -> R
     transform: (T) -> R
): List<R>
): List<R>
</syntaxhighlight>يمكن استدعاء الدالة<code>map()‎</code> على [[Kotlin/Map|القواميس]].<syntaxhighlight lang="kotlin">
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
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)]].
=== <code>transform</code> ===
==القيم المٌعادة==
دالةٌ تطبق على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة. يمرر إليها فهرس العنصر وقيمته وتعيد القيمة المقابلة لهذا العنصر.
تعيد الدالة<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|القاموس]].
 
==القيم المعادة==
تُعاد قائمةٌ تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()mapIndexed</code> مع القواميس===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()mapIndexed</code> لوضع فهرس كل عنصر بجانب قيمته وفقًا لتنسيق معين<nowiki/>:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Map|قاموسًا]] باسم <code>m</code>مكونًا من ثلاثة أزواج باستخدام الدالة <code>()mapOf</code>، ثم تُعرّف الدالة <code>()func</code>، ثم تستخدم الدالة <code>()mapIndexed</code> بتمرير <code>()func</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("$index:$element, ") }
    // 0:1, 1:2, 2:3, 3:4, 4:5, 5:6,  
}
}
</syntaxhighlight>
</syntaxhighlight>
===انظر أيضًا===
==انظر أيضًا==
*<code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code>‎: تضيف إلى [[Kotlin/collections/List|اللائحة]] المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] وفهارسها.
*الدالة <code>[[Kotlin/collections/mapIndexedTo|mapIndexedTo()‎]]</code>: تشبه هذه الدالة في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
*الدالة [[Kotlin/collections/map|<code>map()</code>]]‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها.
*الدالة <code>[[Kotlin/collections/mapNotNull|mapNotNull()‎]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
*الدالة <code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
* الدالة <nowiki/>[[Kotlin/collections/filterIndexed|<code>filterIndexed()</code>‎]]: ترشِّح ترشِّح عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة التي تُعاد القيمة <code>true</code> معها عند تطبيق الدالة <code>predicate()‎</code> المُمرّر عليها، إذ يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()‎</code> ثم تعيد بدورها قيمة منطقيَّة.
==مصادر==
==مصادر==
*[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 Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 08:24، 8 سبتمبر 2018

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

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

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

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

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

المعاملات

transform

دالةٌ تطبق على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة. يمرر إليها فهرس العنصر وقيمته وتعيد القيمة المقابلة لهذا العنصر.

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

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

أمثلة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()mapIndexed لوضع فهرس كل عنصر بجانب قيمته وفقًا لتنسيق معين:

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

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

انظر أيضًا

  • الدالة mapIndexedTo()‎: تشبه هذه الدالة في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
  • الدالة map()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها.
  • الدالة mapNotNull()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
  • الدالة mapIndexedNotNull()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
  • الدالة filterIndexed()‎: ترشِّح ترشِّح عناصر المصفوفة أو المجموعة المعطاة التي تُعاد القيمة true معها عند تطبيق الدالة predicate()‎ المُمرّر عليها، إذ يمرَّر فهرس كل عنصر وقيمته إلى الدالة predicate()‎ ثم تعيد بدورها قيمة منطقيَّة.

مصادر

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