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

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

تعيد الدالة map()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها.

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

inline fun <R> CharSequence.map(
    transform: (Char) -> R
): List<R>

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

المعاملات

`transform`

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

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

تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform على كل محرف من محارف السلسلة المعطاة.

أمثلة

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

fun main(args: Array<String>) {
    val str = "HsoubWiki"

    print(str.map { it.toUpperCase() }) // [H, S, O, U, B, W, I, K, I]
}

انظر أيضًا

الدالة mapTo()‎: تشبه هذه الدالة باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
الدالة mapNotNull()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
الدالة mapIndexed()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف السلسلة التي استُدعيت معها.
الدالة mapIndexedNotNull()‎: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف السلسلة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.
الدالة onEach()‎: تطبّق دالةً محددةً على كل محرف من محارف السلسلة التي استٌدعيت معها، ثم تعيد تلك السلسلة.
الدالة find()‎: تبحث على محرف يحقق شرطًا محدَّدًا ضمن محارف السلسلة التي استُدعيت معها ثمَّ تعيد أول ظهور له.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.map()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.map()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>map()</code>‎ [[Kotlin/String|لائحة]] مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة  على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
+تعيد الدالة <code>map()‎</code> <nowiki/>[[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 6: / سطر 6: @@
      transform: (Char) -> R
 ): List<R>
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>transform</code> ===
+دالةٌ تطبق على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة. يمرر إليها محرفٌ وتعيد القيمة المقابلة له.
 ==القيم المعادة==
-[[Kotlin/String|لائحة]].
+تُعاد <nowiki/>[[Kotlin/collections/List|قائمةٌ]] تضم ناتج تطبيق الدالة <code>transform</code> على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة.
 ==أمثلة==
-===استخدام الدالة <code>map()‎</code> مع السلاسل النصية===
+مثالٌ على استعمال الدالة <code>map()‎</code>:<syntaxhighlight lang="kotlin">
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>map()‎</code> عبرها وتمرر دالة كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "Hsoub Wiki"
+    val str = "HsoubWiki"
-print( str.map {it.toUpperCase()} ) // [H, S, O, U, B,  , W, I, K, I]
+     print(str.map { it.toUpperCase() }) // [H, S, O, U, B, W, I, K, I]
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/kotlin.text/mapTo|mapTo()]]‎</code>: تضيف  إلى المجموعة المتغيرة المُمرّرة <code>destination</code> نتائج تطبيق الدالة <code>transform</code> على عناصر سلسلة الحروف التي استٌدعيت عبرها.
+*الدالة <code>[[Kotlin/kotlin.text/mapTo|mapTo()‎]]</code>: تشبه هذه الدالة باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
-*<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/mapIndexed|mapIndexed()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
+*الدالة <code>[[Kotlin/kotlin.text/mapIndexedNotNull|mapIndexedNotNull()]]</code>‎: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
+*الدالة <nowiki/>[[Kotlin/kotlin.text/onEach|<code>onEach()</code>‎]]: تطبّق دالةً محددةً على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استٌدعيت معها، ثم تعيد تلك <nowiki/>[[Kotlin/CharSequence/index|السلسلة]].
+* الدالة <code>[[Kotlin/kotlin.text/find|find()‎]]</code>: تبحث على محرف يحقق شرطًا محدَّدًا ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map.html صفحة الدالة text.map()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map.html صفحة الدالة CharSequence.map()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]