الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/mapIndexed»
< Kotlin | kotlin.text
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.mapIndexed() في لغة Kotlin}}</noinclude> تعيد الدالة <code>mapIndexed()</code> Kotlin/String|لائح...' |
جميل-بيلوني (نقاش | مساهمات) مراجعة وتدقيق. |
||
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.mapIndexed()</code> في Kotlin}}</noinclude> | ||
تعيد | تعيد الدالة <code>mapIndexed()</code> <nowiki/>[[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
inline fun <R> CharSequence. | inline fun <R> CharSequence.mapIndexed( | ||
transform: (Char) -> R | transform: (index: Int, Char) -> R | ||
): List<R> | ): List<R> | ||
</syntaxhighlight> | </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). | ||
== المعاملات == | |||
=== <code>transform</code> === | |||
دالةٌ تطبق على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة. يمرر إليها فهرس المحرف وقيمته وتعيد القيمة المقابلة لهذا المحرف. | |||
==القيم المعادة== | ==القيم المعادة== | ||
[[Kotlin/ | تُعاد [[Kotlin/collections/List|قائمةٌ]] تضم ناتج تطبيق الدالة <code>transform</code> المُمرّرة على فهرس وقيمة كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة. | ||
==أمثلة== | ==أمثلة== | ||
مثالٌ على استعمال الدالة <code>mapIndexed()</code>:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val str = "Hsoub Wiki" | val str = "Hsoub Wiki" | ||
print( str. | print(str.mapIndexed { index, char -> index + char.toInt() }) // [72, 116, 113, 120, 102, 37, 93, 112, 115, 114] | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
*<code>[[Kotlin/kotlin.text/ | *الدالة <code>[[Kotlin/kotlin.text/mapIndexedTo|mapIndexedTo()]]</code>: تشبه الدالةَ <code>mapIndexed()</code> في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. | ||
*<code>[[Kotlin/text/ | *الدالة <code>[[Kotlin/kotlin.text/map|map()]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها. | ||
*<code>[[Kotlin/text/ | *الدالة <code>[[Kotlin/kotlin.text/mapNotNull|mapNotNull()]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة. | ||
*الدالة <code>[[Kotlin/kotlin.text/mapIndexedNotNull|mapIndexedNotNull()]]</code>: تعيد [[Kotlin/collections/List|قائمةً]] تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة. | |||
* الدالة <code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed()]]</code>: ترشِّح محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على فهرس المحرف وقيمته. | |||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map.html صفحة الدالة | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/map-indexed.html صفحة الدالة CharSequence.mapIndexed() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Text]] | |||
[[تصنيف:Kotlin CharSequence]] |
المراجعة الحالية بتاريخ 10:11، 4 سبتمبر 2018
تعيد الدالة mapIndexed()
قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف السلسلة التي استُدعيت معها.
البنية العامة
inline fun <R> CharSequence.mapIndexed(
transform: (index: Int, Char) -> R
): List<R>
وجود الكلمة المفتاحية inline
يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)).
المعاملات
transform
دالةٌ تطبق على كل محرف من محارف السلسلة المعطاة. يمرر إليها فهرس المحرف وقيمته وتعيد القيمة المقابلة لهذا المحرف.
القيم المعادة
تُعاد قائمةٌ تضم ناتج تطبيق الدالة transform
المُمرّرة على فهرس وقيمة كل محرف من محارف السلسلة المعطاة.
أمثلة
مثالٌ على استعمال الدالة mapIndexed()
:
fun main(args: Array<String>) {
val str = "Hsoub Wiki"
print(str.mapIndexed { index, char -> index + char.toInt() }) // [72, 116, 113, 120, 102, 37, 93, 112, 115, 114]
}
انظر أيضًا
- الدالة
mapIndexedTo()
: تشبه الدالةَmapIndexed()
في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. - الدالة
map()
: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها. - الدالة
mapNotNull()
: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها باستثناء القيم العدميَّةnull
التي تعيدها تلك الدالة. - الدالة
mapIndexedNotNull()
: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف السلسلة التي استُدعيت معها باستثناء القيم العدميَّةnull
التي تعيدها تلك الدالة. - الدالة
filterIndexed()
: ترشِّح محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على فهرس المحرف وقيمته.