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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexedTo()‎</code> في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexedTo()‎</code> في لغة Kotlin}}</noinclude>
تطبق الدالة<code>mapIndexedTo()‎</code> الدالة المُمررّة <code>transform()‎</code> على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها وعلى فهارسها وتضيف النتائج إلى  ا<nowiki/>[[Kotlin/collections/List|لمعامل]] الممرّر <code>destination</code>.
+
<nowiki/>تشبه الدالة <code>mapIndexedTo()‎</code> الدالةَ <code>[[Kotlin/collections/mapIndexed|mapIndexed()‎]]</code> في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
 
 
 
==البنية العامة==
 
==البنية العامة==
يمكن استدعاء الدالة<code>mapIndexedTo()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
+
يمكن استدعاء الدالة<code>mapIndexedTo()‎</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
 
inline fun <T, R, C : MutableCollection<in R>> Array<out T>.mapIndexedTo(
 
inline fun <T, R, C : MutableCollection<in R>> Array<out T>.mapIndexedTo(
 
     destination: C,  
 
     destination: C,  
سطر 41: سطر 40:
 
): C  
 
): C  
  
</syntaxhighlight>يمكن استدعاء الدالة<code>mapIndexedTo()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
 
 
inline fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapIndexedTo(
 
inline fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapIndexedTo(
 
     destination: C,  
 
     destination: C,  
 
     transform: (index: Int, T) -> R
 
     transform: (index: Int, T) -> R
 
): C  
 
): C  
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
==القيم المٌعادة==
+
==القيم المعادة==
الوسيط المُمرّر <code>destination</code> بعد إضافة نتائج تطبيق الدالة المُمررّة <code>transform()‎</code> على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
+
يعاد المعامل <code>destination</code> بعد إضافة ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة إليه.
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة <code>()mapIndexedTo</code> مع المصفوفات===
+
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة  <code>()mapIndexedTo</code>  لتخزين ناتج جمع قيمة كل عنصر من عناصر تلك المصفوفة مع فهرسه في القائمة المتغيرة <code>mutable</code> :<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونًة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، وتعرّف كائنًا من النوع <code>MutableList<Int>‎</code> باسم <code>mutable</code>، ثم تستخدم الدالة  <code>()mapIndexedTo</code> على <code>array</code><nowiki/>، مع تمرير الكائن  <code>mutable</code> ودالة تعيد مجموع قيمة العنصر  وقيمة فهرسه، ثم تطبع <code>mutable</code>:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
 
val array = arrayOf(0, 2, 2, 4, 7, 5)
 
val array = arrayOf(0, 2, 2, 4, 7, 5)
سطر 61: سطر 58:
 
}
 
}
 
</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|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
*<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|القاموس]].
+
*الدالة <code>[[Kotlin/collections/mapIndexedNotNullTo|mapIndexedNotNullTo()]]</code>: تشبه الدالة <code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull()‎]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
 
+
*الدالة [[Kotlin/collections/map|<code>map()</code>]]‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها.
* <code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull()]]</code>‎: تعيد لائحة تضم فقط النتائج غير المعدومة (<code>non-null</code>) لتطبيق الدالة <code>transform()‎</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو<nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها.
 
 
 
 
==مصادر==
 
==مصادر==
 
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-indexed-to.html الدالة  mapIndexedTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-indexed-to.html الدالة  mapIndexedTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

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

تشبه الدالة mapIndexedTo()‎ الدالةَ mapIndexed()‎ في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

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

يمكن استدعاء الدالةmapIndexedTo()‎ مع المصفوفات والمجموعات:

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

inline fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapIndexedTo(
    destination: C, 
    transform: (index: Int, T) -> R
): C

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

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

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

أمثلة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثم تستخدم الدالة  ()mapIndexedTo  لتخزين ناتج جمع قيمة كل عنصر من عناصر تلك المصفوفة مع فهرسه في القائمة المتغيرة mutable :

fun main(args: Array<String>) {
val array = arrayOf(0, 2, 2, 4, 7, 5)
val mutable: MutableList<Int> = mutableListOf()
    
array.mapIndexedTo (mutable) { a, b -> a + b }
    
println(mutable)   //  [0, 3, 4, 7, 11, 10]
}

انظر أيضًا

مصادر