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

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

تشبه الدالة mapTo()‎ الدالة map()‎ باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.

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

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

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

المعاملات

`destination`

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

`transform`

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

أمثلة

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

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

    str.mapTo(list) { char -> char.toInt() }
    print(list) // [[72, 115, 111, 117, 98, 32, 87, 105, 107, 105]
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.mapTo()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.mapTo()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>mapTo()</code>‎ [[Kotlin/String|لائحة]] مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة  على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
+تشبه الدالة <code>mapTo()‎</code> الدالة <code>[[Kotlin/collections/map|map()‎]]</code> باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun <R> CharSequence.map(
+inline fun <R, C : MutableCollection<in R>> CharSequence.mapTo(
+    destination: C,
      transform: (Char) -> R
-): List<R>
+): C
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
-==القيم المعادة==
+==المعاملات==
-[[Kotlin/String|لائحة]].
-==أمثلة==
+=== <code>destination</code> ===
-===استخدام الدالة <code>mapTo()‎</code> مع السلاسل النصية===
+[[Kotlin/collections/MutableCollection|مجموعة متغيرة]] تمثل الوجهة التي سيضاف إليها الناتج الذي تعيده الدالة <code>transform</code>.
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>mapTo()‎</code> عبرها وتمرر دالة كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+=== <code>transform</code> ===
+دالةٌ تطبق على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة. يمرر إليها محرفٌ وتعيد القيمة المقابلة له.
+== أمثلة ==
+مثالٌ على استعمال الدالة <code>mapTo()‎</code>:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "Hsoub Wiki"
+    val str = "Hsoub Wiki"
+     val list = mutableListOf<Int>()
-print( str.map {it.toUpperCase()} ) // [H, S, O, U, B,  , W, I, K, I]
+    str.mapTo(list) { char -> char.toInt() }
+    print(list) // [[72, 115, 111, 117, 98, 32, 87, 105, 107, 105]
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/kotlin.text/lineSequence|lineSequence()]]‎</code>: تقسّم [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها إلى سلسلة مكونة من سطور مفصولة بأيٍّ من [[Kotlin/CharSequence/index|سلاسل الحروف]] التالية <code>CRLF</code> أو  <code>LF</code> أو <code>CR</code>.
+*الدالة <code>[[Kotlin/kotlin.text/map|map()‎]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
-*<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]‎</code>: تعيد  [[Kotlin/String|لائحة]] مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة  على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى فهارسها.
+*الدالة <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/mapIndexedNotNullTo|mapIndexedNotNullTo()‎]]</code>: تشبه الدالة <code>mapIndexedNotNull()‎</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
+* الدالة <nowiki/>[[Kotlin/kotlin.text/filterTo|<code>filterTo()</code>‎]]: تشبه الدالة <code>filter()</code>‎ تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map.html صفحة الدالة text.mapTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map-to.html صفحة الدالة CharSequence.mapTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]