الفرق بين المراجعتين ل"Kotlin/kotlin.text/map"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.map()‎ في لغة Kotlin}}</noinclude> تقسّم الدالة <code>map()</code>‎ Kotlin/CharSequence/index|سلسل...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: التابع text.map()‎ في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: التابع text.map()‎ في لغة Kotlin}}</noinclude>
تقسّم الدالة <code>map()</code>‎ [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها إلى [[Kotlin/String|لائحة]] مكونة من سطور مفصولة بأيٍّ من [[Kotlin/CharSequence/index|سلاسل الحروف]] التالية <code>CRLF</code> أو  <code>LF</code> أو <code>CR</code>.
+
تعيد الدالة <code>map()</code>‎ [[Kotlin/String|لائحة]] مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة  على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
fun CharSequence.lines(): List<String>  
+
inline fun <R> CharSequence.map(
 
+
    transform: (Char) -> R
 +
): List<R>
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==القيم المعادة==
 
==القيم المعادة==
سطر 10: سطر 11:
 
==أمثلة==
 
==أمثلة==
 
===استخدام الدالة <code>map()‎</code> مع السلاسل النصية===
 
===استخدام الدالة <code>map()‎</code> مع السلاسل النصية===
تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>map()‎</code> عبرها وتستخدم الناتج في الحلقة التكرارية <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>:<syntaxhighlight lang="kotlin">
+
تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>map()‎</code> عبرها وتمرر دالة كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
val str = "Hsoub\nWiki\nacademy"  
+
val str = "Hsoub Wiki"  
 
      
 
      
for (line in str.lines())  print("$line ") // Hsoub Wiki academy
+
print( str.map {it.toUpperCase()} ) // [H, S, O, U, B,  , W, I, K, I]
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
سطر 22: سطر 23:
 
*<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
 
*<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
 
==مصادر==
 
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/lines.html صفحة الدالة text.map()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map.html صفحة الدالة text.map()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Method]]
 
[[تصنيف:Kotlin Method]]

مراجعة 11:07، 10 يوليو 2018

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

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

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

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

لائحة.

أمثلة

استخدام الدالة map()‎ مع السلاسل النصية

تُعرّف الشيفرة الآتية سلسلة نصية باسم str، ثم تستدعي الدالة map()‎ عبرها وتمرر دالة كوسيط، ثم تطبع الناتج:

fun main(args: Array<String>) {
val str = "Hsoub Wiki" 
    
print( str.map {it.toUpperCase()} ) // [H, S, O, U, B,  , W, I, K, I]
}

انظر أيضًا

  • lineSequence(): تقسّم سلسلة الحروف التي استٌدعيت عبرها إلى سلسلة مكونة من سطور مفصولة بأيٍّ من سلاسل الحروف التالية CRLF أو LF أو CR.
  • isHighSurrogate(): تعيد القيمة true في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
  • isDefined(): تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر