الفرق بين المراجعتين ل"Kotlin/collections/mapIndexed"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<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/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()</code> المُمرّرة إليها على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها. |
==البنية العامة== | ==البنية العامة== | ||
| − | يمكن استدعاء الدالة<code> | + | يمكن استدعاء الدالة<code>mapIndexed()</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin"> |
| − | inline fun <T, R> Array<out T>. | + | 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> ShortArray.mapIndexed( | |
| − | inline fun <R> ShortArray. | + | transform: (index: Int, Short) -> R |
| − | transform: (Short) -> R | ||
): List<R> | ): List<R> | ||
| − | inline fun <R> IntArray. | + | inline fun <R> IntArray.mapIndexed( |
| − | + | transform: (index: Int, Int) -> R | |
| − | |||
| − | |||
): List<R> | ): List<R> | ||
| − | inline fun <R> | + | inline fun <R> LongArray.mapIndexed( |
| − | transform: ( | + | transform: (index: Int, Long) -> R |
): List<R> | ): List<R> | ||
| − | inline fun <R> BooleanArray. | + | 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> | ||
| − | |||
| − | </syntaxhighlight>يمكن استدعاء الدالة<code> | + | </syntaxhighlight>يمكن استدعاء الدالة<code>mapIndexed()</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin"> |
| − | inline fun <T, R> Iterable<T>. | + | inline fun <T, R> Iterable<T>.mapIndexed( |
| − | transform: ( | + | transform: (index: Int, T) -> 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)]]. | ||
==القيم المٌعادة== | ==القيم المٌعادة== | ||
| − | + | [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()</code> المُمرّرة إليها على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها. | |
==أمثلة== | ==أمثلة== | ||
| − | ===استخدام الدالة <code>()mapIndexed</code> مع | + | ===استخدام الدالة <code>()mapIndexed</code> مع المصفوفات=== |
| − | تعرف الشيفرة الآتية <nowiki/>[[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 | + | 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 | ||
} | } | ||
</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) القاموس.