الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/mapIndexedNotNullTo»

المراجعة الحالية بتاريخ 10:11، 4 سبتمبر 2018

تشبه الدالة mapIndexedNotNullTo()‎ الدالة mapIndexedNotNull()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

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

inline fun <R : Any, C : MutableCollection<in R>> CharSequence.mapIndexedNotNullTo(
    destination: C, 
    transform: (index: Int, Char) -> R?
): C

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

المعاملات

`destination`

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

`transform`

دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها فهرس المحرف وقيمته وتعيد القيمة المقابلة لهذا المحرف.

أمثلة

مثالٌ على استعمال الدالة mapIndexedNotNullTo()‎:

fun main(args: Array<String>) {
    val str = "Hsoub Wiki"
    val list = mutableListOf<Int>()

    str.mapIndexedNotNullTo(list) { index, char -> if (index < 5) index + char.toInt() else null }
    print(list) // [72, 116, 113, 120, 102]
}

انظر أيضًا

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

مصادر

صفحة الدالة CharSequence.mapIndexedNotNullTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.mapIndexedNotNullTo()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.mapIndexedNotNullTo()‎</code> في Kotlin}}</noinclude>
-تضيف الدالة <code>mapIndexedNotNullTo()</code>‎ إلى المجموعة المتغيرة المُمرّرة <code>destination</code> نتائج تطبيق الدالة <code>transform</code> على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى فهارسها.
+تشبه الدالة <code>mapIndexedNotNullTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/mapIndexedNotNull|mapIndexedNotNull()‎]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun <R, C : MutableCollection<in R>> CharSequence.mapIndexedTo(
+inline fun <R : Any, C : MutableCollection<in R>> CharSequence.mapIndexedNotNullTo(
      destination: C,
-     transform: (index: Int, Char) -> R
+     transform: (index: Int, Char) -> R?
 ): C
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+==المعاملات==
+=== <code>destination</code> ===
+[[Kotlin/collections/MutableCollection|مجموعة متغيرة]] تمثل الوجهة التي سيضاف إليها الناتج الذي تعيده الدالة <code>transform</code>.
+=== <code>transform</code> ===
+دالةٌ تطبق على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة. يمرر إليها فهرس المحرف وقيمته وتعيد القيمة المقابلة لهذا المحرف.
-==القيم المعادة==
-المجموعة المتغيرة <code>destination</code>.
 ==أمثلة==
-===استخدام الدالة <code>mapIndexedNotNullTo()‎</code> مع السلاسل النصية===
+مثالٌ على استعمال الدالة <code>mapIndexedNotNullTo()‎</code>:<syntaxhighlight lang="kotlin">
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، وكائنا من النوع  <code>mutableList</code> باسم <code>list</code> ثم تستدعي الدالة <code>mapIndexedNotNullTo()‎</code> عبرها وتمرر دالة كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "Hsoub Wiki"
+    val str = "Hsoub Wiki"
-val list = mutableListOf<Int>()
+    val list = mutableListOf<Int>()
-str.mapIndexedTo (list) { index, char -> index + char.toInt()}
+    str.mapIndexedNotNullTo(list) { index, char -> if (index < 5) index + char.toInt() else null }
+     print(list) // [72, 116, 113, 120, 102]
-print( list ) // [72, 116, 113, 120, 102, 37, 93, 112, 115, 114]
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/map|map()]]‎</code>: تعيد‎ لائحة مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها.
+*الدالة <code>[[Kotlin/kotlin.text/map|map()‎]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
+*الدالة <code>[[Kotlin/kotlin.text/mapTo|mapTo()‎]]</code>: تشبه هذه الدالة باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
-* <code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]‎</code>: تعيد لائحة مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها وعلى فهارسها.
+*الدالة <code>[[Kotlin/kotlin.text/mapNotNull|mapNotNull()‎]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
+*الدالة <code>[[Kotlin/kotlin.text/mapNotNullTo|mapNotNullTo()‎]]</code>: تشبه الدالة <code>mapNotNull()‎</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
+*الدالة <code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
+*الدالة <code>[[Kotlin/kotlin.text/mapIndexedTo|mapIndexedTo()‎]]</code>: تشبه الدالةَ <code>mapIndexed()‎</code> في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
+*الدالة <code>[[Kotlin/kotlin.text/mapIndexedNotNull|mapIndexedNotNull()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
+* الدالة <code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed()]]‎</code>: ترشِّح محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على فهرس المحرف وقيمته.
+* الدالة <code>[[Kotlin/kotlin.text/filterIndexedTo|filterIndexedTo()]]‎</code>: تشبه الدالة <nowiki/>[[Kotlin/kotlin.text/filterIndexed|<code>filterIndexed()</code>‎]] تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map-indexed-to.html صفحة الدالة text.mapIndexedNotNullTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map-indexed-not-null-to.html صفحة الدالة CharSequence.mapIndexedNotNullTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]