الفرق بين المراجعتين ل"Kotlin/collections/mapIndexed"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
| سطر 53: | سطر 53: | ||
*<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|القاموس]]. | *<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/mapIndexedNotNull|mapIndexedNotNull()]]</code>: تعيد [[Kotlin/collections/List|لائحة]] تضم فقط النتائج غير المعدومة (<code>non-null</code>) لتطبيق الدالة <code>transform()</code> على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وعلى فهارسها. | ||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-indexed.html الدالة mapIndexed() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-indexed.html الدالة mapIndexed() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 18:10، 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) القاموس.mapIndexedNotNull(): تعيد لائحة تضم فقط النتائج غير المعدومة (non-null) لتطبيق الدالةtransform()على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها.