الفرق بين المراجعتين ل"Kotlin/kotlin.text/mapTo"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.mapTo() في لغة Kotlin}}</noinclude> تعيد الدالة <code>mapTo()</code> لائحة مك...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع text.mapTo() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: التابع text.mapTo() في لغة Kotlin}}</noinclude> | ||
| − | + | تضيف الدالة <code>mapTo()</code> إلى المجموعة المتغيرة المُمرّرة <code>destination</code> نتائج تطبيق الدالة <code>transform</code> على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها. | |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| − | inline fun <R> CharSequence. | + | inline fun <R, C : MutableCollection<in R>> CharSequence.mapTo( |
| + | destination: C, | ||
transform: (Char) -> R | transform: (Char) -> R | ||
| − | ): | + | ): C |
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
==القيم المعادة== | ==القيم المعادة== | ||
| − | + | المجموعة المتغيرة <code>destination</code>. | |
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>mapTo()</code> مع السلاسل النصية=== | ===استخدام الدالة <code>mapTo()</code> مع السلاسل النصية=== | ||
| − | تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>mapTo()</code> عبرها وتمرر دالة كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | + | تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، وكائنا من النوع <code>mutableList</code> باسم <code>list</code> ثم تستدعي الدالة <code>mapTo()</code> عبرها وتمرر دالة كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> |
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val str = "Hsoub Wiki" | val str = "Hsoub Wiki" | ||
| + | val list = mutableListOf<Int>() | ||
| + | |||
| + | str.mapTo (list) { char -> char.toInt()} | ||
| − | print( | + | print( list ) // [[72, 115, 111, 117, 98, 32, 87, 105, 107, 105] |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
| − | *<code>[[Kotlin/kotlin.text/ | + | * <code>[[Kotlin/kotlin.text/map|map()]]</code>: تعيد لائحة مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها. |
| − | *<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]</code>: | + | |
| + | * <code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]</code>: تعيد لائحة مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها وعلى فهارسها. | ||
==مصادر== | ==مصادر== | ||
| − | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map.html صفحة الدالة text.mapTo() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | + | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map-to.html صفحة الدالة text.mapTo() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Method]] | [[تصنيف:Kotlin Method]] | ||
مراجعة 11:30، 10 يوليو 2018
تضيف الدالة mapTo() إلى المجموعة المتغيرة المُمرّرة destination نتائج تطبيق الدالة transform على عناصر سلسلة الحروف التي استٌدعيت عبرها.
البنية العامة
inline fun <R, C : MutableCollection<in R>> CharSequence.mapTo(
destination: C,
transform: (Char) -> R
): C
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
المجموعة المتغيرة destination.
أمثلة
استخدام الدالة mapTo() مع السلاسل النصية
تُعرّف الشيفرة الآتية سلسلة نصية باسم str، وكائنا من النوع mutableList باسم list ثم تستدعي الدالة mapTo() عبرها وتمرر دالة كوسيط، ثم تطبع الناتج:
fun main(args: Array<String>) {
val str = "Hsoub Wiki"
val list = mutableListOf<Int>()
str.mapTo (list) { char -> char.toInt()}
print( list ) // [[72, 115, 111, 117, 98, 32, 87, 105, 107, 105]
}
انظر أيضًا
map(): تعيد لائحة مكونة من نتائج تطبيق الدالةtransformالمُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها.
mapIndexed(): تعيد لائحة مكونة من نتائج تطبيق الدالةtransformالمُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها وعلى فهارسها.