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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
ط
 
(3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 49: سطر 49:
 
): C  
 
): C  
 
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق [[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> ===
 +
[[Kotlin/collections/MutableCollection|مجموعة متغيرة]] تمثل الوجهة التي سيضاف إليها الناتج الذي تعيده الدالة <code>transform</code>.
 +
 
 +
=== <code>transform</code> ===
 +
دالةٌ تطبق على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة المعطاة. يمرر إليها العنصر وتعيد القيمة المقابلة له.
 +
 
 
==أمثلة==
 
==أمثلة==
 
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()mapTo</code> لضرب قيمة كل عنصر من عناصر تلك المصفوفة بالقيمة 10 ثم تخزين الناتج في القائمة المتغيرة <code>mutable</code>:<syntaxhighlight lang="kotlin">
 
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()mapTo</code> لضرب قيمة كل عنصر من عناصر تلك المصفوفة بالقيمة 10 ثم تخزين الناتج في القائمة المتغيرة <code>mutable</code>:<syntaxhighlight lang="kotlin">
سطر 66: سطر 72:
 
*الدالة <code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 
*الدالة <code>[[Kotlin/collections/mapIndexed|mapIndexed()]]</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|المجموعة]] التي استُدعيت عبرها وعلى فهارسها.
+
*الدالة <code>[[Kotlin/collections/mapIndexedNotNull|mapIndexedNotNull()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
 +
*الدالة <code>[[Kotlin/collections/mapNotNull|mapNotNull()‎]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
 +
*الدالة <code>[[Kotlin/collections/mapNotNullTo|mapNotNullTo()‎]]</code>: تشبه الدالة <code>[[Kotlin/collections/mapNotNull|mapNotNull()‎]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
 +
* الدالة <code>[[Kotlin/collections/filter|filter()]]</code>‎: ترشِّح عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها.
 +
* الدالة <code>[[Kotlin/collections/filterTo|filterTo()‎]]</code>: تشبه هذه الدالة في جميع النواحي باستثناء أنها تضيف الناتج إلى المعامل الممرر إليها.
 
==مصادر==
 
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-to.html صفحة الدالة mapTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>mapTo()‎</code> في لغة Kotlin}}</noinclude>
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-to.html صفحة الدالة mapTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>mapTo()‎</code> في Kotlin}}</noinclude>
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Collection]]

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

تشبه الدالة mapTo()‎ الدالة map()‎ باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.

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

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

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

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

inline fun <K, V, R, C : MutableCollection<in R>> Map<out K, V>.mapTo(
    destination: C, 
    transform: (Entry<K, V>) -> R
): C

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

المعاملات

destination

مجموعة متغيرة تمثل الوجهة التي سيضاف إليها الناتج الذي تعيده الدالة transform.

transform

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

أمثلة

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

fun main(args: Array<String>) {
val array = arrayOf(0, 2, 2, 4, 7, 5)
val mutable: MutableList<Int> = mutableListOf()
    
array.mapTo (mutable) { a -> a*10  }
    
println(mutable)   // [0, 20, 20, 40, 70, 50]
}

انظر أيضًا

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

مصادر