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

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

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

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

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

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

المعاملات

`transform`

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

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

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

أمثلة

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

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

    println(str.flatMap { a -> listOf(a) }) // [h, s, o, u, b,  , W, i, k, i]
}

انظر أيضًا

الدالة flatMapTo()‎: تشبه الدالة flatMap()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى كائن موجود مسبقًا بدلًا من إعادته فقط.
الدالة filter()‎: ترشِّح محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.flatMap()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.flatMap()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>flatMap()</code>‎ [[Kotlin/Char/index|الحرف]] الأول من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية <code>predicate</code> كوسيط فستعيد  [[Kotlin/Char/index|الحرف]] الأول الذي يحقق الشرط المنطقي <code>predicate</code>.
+تعيد الدالة <code>flatMap()‎</code> <nowiki/>[[Kotlin/collections/List|قائمةً]] تضم ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
-تطلق   الدالة <code>first()</code>‎  استثناء <code>NoSuchElementException</code> إن كانت  [[Kotlin/CharSequence/index|سلسلة الحروف]] فارغة أو لم يكن هناك أي حرف يحقق  الشرط المنطقي.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.first(): Char
+inline fun <R> CharSequence.flatMap(
+    transform: (Char) -> Iterable<R>
+): List<R>
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
-inline fun CharSequence.first(
+== المعاملات ==
-    predicate: (Char) -> Boolean
-): Char
+=== <code>transform</code> ===
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة، وتعيد قيمة معينة تحل مكانه.
 ==القيم المعادة==
-[[Kotlin/Char/index|حرف]].
+تُعاد [[Kotlin/collections/List|قائمةٌ]] تضم ناتج تطبيق الدالة <code>transform‎</code> على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة.
 ==أمثلة==
-===استخدام الدالة <code>()flatMap</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()flatMap</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()flatMap</code> عبرها مع تمرير دالة منطقية كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "hsoub Wiki"
+    val str = "hsoub Wiki"
-println(str.first {it.isUpperCase()} ) //  W
+     println(str.flatMap { a -> listOf(a) }) // [h, s, o, u, b,  , W, i, k, i]
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/firstOrNull|firstOrNull()]]‎</code>: تعيد  [[Kotlin/Char/index|الحرف]] الأول من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية <code>predicate</code> كوسيط فستعيد  [[Kotlin/Char/index|الحرف]] الأول الذي يحقق الشرط المنطقي <code>predicate</code>.
+* الدالة <code>[[Kotlin/kotlin.text/flatMapTo|flatMapTo()]]‎</code>: تشبه الدالة <code>flatMap()‎</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى كائن موجود مسبقًا بدلًا من إعادته فقط.
-* <code>[[Kotlin/kotlin.text/find|find()]]‎</code>: تعيد أول حرف من سلسلة الحروف التي استُدعيت عبرها يحقق الشرط المنطقي <code>predicate.</code>
+* الدالة <code>[[Kotlin/kotlin.text/filter|filter()‎]]</code>: ترشِّح محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.
-* <code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed()]]‎</code>: تعيد الدالة <code>filterIndexed()</code>‎ كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()‎</code> ثم تعيد بدورها قيمة منطقيَّة.
-* <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]‎</code>: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/first.html الدالة text.flatMap()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/flat-map.html صفحة الدالة CharSequence.flatMap()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]