الفرق بين المراجعتين ل"Kotlin/collections/mapTo"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>mapTo()</code> في لغة Kotlin}}</noinclude> تطبق الدالة<code>mapTo()</code> الدالة المُمرر...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>mapTo()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>mapTo()</code> في لغة Kotlin}}</noinclude> | ||
| − | تطبق الدالة<code>mapTo()</code> الدالة المُمررّة <code>transform()</code> على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها | + | تطبق الدالة<code>mapTo()</code> الدالة المُمررّة <code>transform()</code> على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وتضيف النتائج إلى ا<nowiki/>[[Kotlin/collections/List|لمعامل]] الممرّر <code>destination</code>. وفي حال استدعاء الدالة <code>mapTo()</code> على <nowiki/>[[Kotlin/Map|قاموس]] فستضيف نتائج تطبيق الدالة<code>transform()</code> على مداخل (entries) <nowiki/>[[Kotlin/Map|القاموس]] إلى ا<nowiki/>[[Kotlin/collections/List|لمعامل]] الممرّر <code>destination</code>. |
==البنية العامة== | ==البنية العامة== | ||
يمكن استدعاء الدالة<code>mapTo()</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin"> | يمكن استدعاء الدالة<code>mapTo()</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin"> | ||
| − | inline fun <T, R | + | inline fun <T, R, C : MutableCollection<in R>> Array<out T>.mapTo( |
destination: C, | destination: C, | ||
| − | transform: (T) -> R | + | transform: (T) -> R |
): C | ): 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 | ||
| + | |||
</syntaxhighlight>يمكن استدعاء الدالة<code>mapTo()</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin"> | </syntaxhighlight>يمكن استدعاء الدالة<code>mapTo()</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin"> | ||
| − | inline fun <T, R | + | inline fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapTo( |
destination: C, | destination: C, | ||
| − | transform: (T) -> R | + | transform: (T) -> R |
): C | ): C | ||
| − | </syntaxhighlight>يمكن استدعاء الدالة<code> | + | </syntaxhighlight>يمكن استدعاء الدالة<code>mapTo()</code> على [[Kotlin/collections|القواميس]]:<syntaxhighlight lang="kotlin"> |
| − | inline fun <K, V, R | + | inline fun <K, V, R, C : MutableCollection<in R>> Map<out K, V>.mapTo( |
destination: C, | destination: C, | ||
| − | transform: (Entry<K, V>) -> R | + | transform: (Entry<K, V>) -> R |
): C | ): C | ||
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
==القيم المٌعادة== | ==القيم المٌعادة== | ||
| − | الوسيط المُمرّر <code>destination</code> بعد إضافة | + | الوسيط المُمرّر <code>destination</code> بعد إضافة نتائج تطبيق الدالة المُمررّة <code>transform()</code> على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/Map|القاموس]] <nowiki/>الذي استُدعيت عبره. |
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()mapTo</code> مع المصفوفات=== | ===استخدام الدالة <code>()mapTo</code> مع المصفوفات=== | ||
| − | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونًة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، وتعرّف كائنًا من النوع <code> | + | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونًة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، وتعرّف كائنًا من النوع <code>MutableList<Int></code> باسم <code>mutable</code>، ثم تستدعي الدالةَ <code>()mapTo</code> عبر <code>array</code><nowiki/>، مع تمرير الكائن <code>mutable</code> ودالة تعيد قيمة العنصر الممرر إليها مضروب في 10، ثم تطبع <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) | ||
val mutable: MutableList<Int> = mutableListOf() | val mutable: MutableList<Int> = mutableListOf() | ||
| − | array. | + | array.mapTo (mutable) { a -> a*10 } |
| − | println(mutable) // [ | + | println(mutable) // [0, 20, 20, 40, 70, 50] |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 40: | سطر 73: | ||
==مصادر== | ==مصادر== | ||
| − | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-to.html الدالة mapTo() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 19:29، 29 مايو 2018
تطبق الدالةmapTo() الدالة المُمررّة transform() على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وتضيف النتائج إلى المعامل الممرّر destination. وفي حال استدعاء الدالة mapTo() على قاموس فستضيف نتائج تطبيق الدالةtransform() على مداخل (entries) القاموس إلى المعامل الممرّر destination.
البنية العامة
يمكن استدعاء الدالة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
يمكن استدعاء الدالةmapTo() على المجموعات.
inline fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapTo(
destination: C,
transform: (T) -> R
): C
يمكن استدعاء الدالةmapTo() على القواميس:
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() على عناصر المصفوفة أو المجموعة أو القاموس الذي استُدعيت عبره.
أمثلة
استخدام الدالة ()mapTo مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونًة من ستة أعداد باستخدام الدالة ()arrayOf، وتعرّف كائنًا من النوع MutableList<Int> باسم mutable، ثم تستدعي الدالةَ ()mapTo عبر array، مع تمرير الكائن mutable ودالة تعيد قيمة العنصر الممرر إليها مضروب في 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]
}
انظر أيضًا
mapIndexed(): تضيف إلى اللائحة المُمرّرة إليها ناتج تطبيق الدالةtransform()المُمرّرة إليها على عناصر المصفوفة أو المجموعة أو القاموس وفهارسها.map(): تعيد لائحة تضم ناتج تطبيق الدالةtransform()المُمرّرة إليها على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال استدعاء الدالةmap()على قاموس فستعيد لائحة تضم ناتج تطبيق الدالةtransform()على مداخل (entries) القاموس.
mapIndexedNotNull(): تعيد لائحة تضم فقط النتائج غير المعدومة (non-null) لتطبيق الدالةtransform()على عناصر المصفوفة أوالمجموعة التي استُدعيت عبرها وعلى فهارسها.