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

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

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

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

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

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

المعاملات

`destination`

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

`transform`

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

أمثلة

مثالُ على استعمال الدالة mapIndexedTo()‎:

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

    str.mapIndexedTo(list) { index, char -> index + char.toInt() }
    print(list) // [72, 116, 113, 120, 102, 37, 93, 112, 115, 114]
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.mapIndexedTo()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.mapIndexedTo()‎</code> في Kotlin}}</noinclude>
-تضيف الدالة <code>mapIndexedTo()</code>‎ إلى المجموعة المتغيرة المُمرّرة <code>destination</code> نتائج تطبيق الدالة <code>transform</code> على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
+تشبه الدالة <code>mapIndexedTo()‎</code> الدالةَ <code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()‎]]</code> في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun <R, C : MutableCollection<in R>> CharSequence.mapTo(
+inline fun <R, C : MutableCollection<in R>> CharSequence.mapIndexedTo(
      destination: C,
-     transform: (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>mapIndexedTo()‎</code> مع السلاسل النصية===
+مثالُ على استعمال الدالة <code>mapIndexedTo()‎</code>:<syntaxhighlight lang="kotlin">
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، وكائنا من النوع  <code>mutableList</code> باسم <code>list</code> ثم تستدعي الدالة <code>mapIndexedTo()‎</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.mapTo (list) { char -> char.toInt()}
+    str.mapIndexedTo(list) { index, char -> index + char.toInt() }
+     print(list) // [72, 116, 113, 120, 102, 37, 93, 112, 115, 114]
-print( list ) // [[72, 115, 111, 117, 98, 32, 87, 105, 107, 105]
 }
 </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/mapIndexedNotNull|mapIndexedNotNull()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
+*الدالة <code>[[Kotlin/kotlin.text/mapIndexedNotNullTo|mapIndexedNotNullTo()‎]]</code>: تشبه الدالة <code>mapIndexedNotNull()‎</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-to.html صفحة الدالة text.mapIndexedTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map-indexed-to.html صفحة الدالة CharSequence.mapIndexedTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]