الفرق بين المراجعتين لصفحة: «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).

مصادر