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

مراجعة 23:12، 8 يوليو 2018

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

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

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

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

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

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

أمثلة

استخدام الدالة `()flatMap` مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()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]
}

انظر أيضًا

firstOrNull()‎: تعيد الحرف الأول من سلسلة الحروف التي استُدعيت عبرها، وفي حال تمرير دالة منطقية predicate كوسيط فستعيد الحرف الأول الذي يحقق الشرط المنطقي predicate.
find()‎: تعيد أول حرف من سلسلة الحروف التي استُدعيت عبرها يحقق الشرط المنطقي predicate.

filterIndexed()‎: تعيد الدالة filterIndexed()‎ كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالة predicate()‎ ثم تعيد بدورها قيمة منطقيَّة.

elementAt()‎: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء IndexOutOfBoundsException.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.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> لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها.
-تطلق   الدالة <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>
-inline fun CharSequence.first(
+): List<R>
-     predicate: (Char) -> Boolean
-): Char
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المعادة==
-[[Kotlin/Char/index|حرف]].
+ لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر  [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها.
 ==أمثلة==
 ===استخدام الدالة <code>()flatMap</code> مع سلسلة نصية===
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</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"
-println(str.first {it.isUpperCase()} ) //  W
+println(str.flatMap { a -> listOf(a) }) // [h, s, o, u, b,  , W, i, k, i]
 }
 </syntaxhighlight>
@@ سطر 33: / سطر 29: @@
 ==مصادر==
-*[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 الدالة text.flatMap()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]