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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexedNotNull()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>mapIndexedNotNull()‎</code> K...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexedNotNull()‎</code> في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>mapIndexedNotNull()‎</code> في لغة Kotlin}}</noinclude>
−
تعيد الدالة<code>mapIndexedNotNull()‎</code> [[Kotlin/collections/List|لائحة]] تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها وعلى فهارسها.
+
تعيد الدالة<code>mapIndexedNotNull()‎</code> [[Kotlin/collections/List|لائحة]] تضم فقط النتائج غير المعدومة (<code>non-null</code>) لتطبيق الدالة <code>transform()‎</code> على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها وعلى فهارسها.
  
 
==البنية العامة==
 
==البنية العامة==
−
يمكن استدعاء الدالة<code>mapIndexed()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
+
يمكن استدعاء الدالة<code>mapIndexedNotNull()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
−
inline fun <T, R> Array<out T>.mapIndexed(
+
inline fun <T, R : Any> Array<out T>.mapIndexedNotNull(
−
     transform: (index: Int, T) -> R
+
     transform: (index: Int, T) -> R?
 
): List<R>
 
): List<R>
−
inline fun <R> ByteArray.mapIndexed(
+
</syntaxhighlight>يمكن استدعاء الدالة<code>mapIndexedNotNull()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
−
    transform: (index: Int, Byte) -> R
+
inline fun <T, R : Any> Iterable<T>.mapIndexedNotNull(
−
): List<R>
+
     transform: (index: Int, T) -> 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>
 
−
 
 
−
</syntaxhighlight>يمكن استدعاء الدالة<code>mapIndexed()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
 
−
inline fun <T, R> Iterable<T>.mapIndexed(
 
−
     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|المجموعة]]  التي استُدعيت عبرها وعلى فهارسها.
+
[[Kotlin/collections/List|لائحة]] تضم فقط النتائج غير المعدومة (<code>non-null</code>) لتطبيق الدالة <code>transform()‎</code> على عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها وعلى فهارسها.
 
==أمثلة==
 
==أمثلة==
 
===استخدام الدالة <code>()mapIndexedNotNull</code> مع المصفوفات===
 
===استخدام الدالة <code>()mapIndexedNotNull</code> مع المصفوفات===
−
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونًا من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()mapIndexedNotNull</code> على <code>array</code><nowiki/>، مع تمرير دالة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونًا من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()mapIndexedNotNull</code> على <code>array</code><nowiki/>، مع تمرير دالة تعيد <code>null</code> إن كانت قيمة العنصر تخالف قيمة فهرسه أو تعيد العنصر نفسه، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
−
val array = arrayOf(1, 2, 3, 4, 5, 6)
+
val array = arrayOf(0, 2, 2, 4, 7, 5)
  
−
array.mapIndexed{index, element  -> print("$element:$index ") }
+
println(array.mapIndexedNotNull { a, b -> if (a==b) a else null })  // [0, 2, 5]
−
    // 1:0 2:1 3:2 4:3 5:4 6:5  
 
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
سطر 53: سطر 27:
 
*<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|القاموس]].
 
==مصادر==
 
==مصادر==
−
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-indexed.html الدالة  mapIndexedNotNull()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/map-indexed-not-null.html الدالة  mapIndexedNotNull()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

مراجعة 18:10، 29 مايو 2018

تعيد الدالةmapIndexedNotNull()‎ لائحة تضم فقط النتائج غير المعدومة (non-null) لتطبيق الدالة transform()‎ على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها.

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

يمكن استدعاء الدالةmapIndexedNotNull()‎ على المصفوفات.

inline fun <T, R : Any> Array<out T>.mapIndexedNotNull(
    transform: (index: Int, T) -> R?
): List<R>

يمكن استدعاء الدالةmapIndexedNotNull()‎ على المجموعات.

inline fun <T, R : Any> Iterable<T>.mapIndexedNotNull(
    transform: (index: Int, T) -> R?
): List<R>

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

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

لائحة تضم فقط النتائج غير المعدومة (non-null) لتطبيق الدالة transform()‎ على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها وعلى فهارسها.

أمثلة

استخدام الدالة ()mapIndexedNotNull مع المصفوفات

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونًا من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة  ()mapIndexedNotNull على array، مع تمرير دالة تعيد null إن كانت قيمة العنصر تخالف قيمة فهرسه أو تعيد العنصر نفسه، ثم تطبع الناتج:

fun main(args: Array<String>) {
val array = arrayOf(0, 2, 2, 4, 7, 5)

println(array.mapIndexedNotNull { a, b -> if (a==b) a else null })   //  [0, 2, 5]
}

انظر أيضًا

  • mapIndexed()‎: تضيف إلى اللائحة المُمرّرة إليها ناتج تطبيق الدالة transform()‎ المُمرّرة إليها على عناصر المصفوفة أو المجموعة أو القاموس وفهارسها.
  • map()‎: تعيد لائحة تضم ناتج تطبيق الدالة transform()‎ المُمرّرة إليها على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال استدعاء الدالة map()‎ على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة transform()‎ على مداخل (entries) القاموس.

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/collections/mapIndexedNotNull&oldid=9529"