الفرق بين المراجعتين ل"Kotlin/kotlin.text/onEach"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط |
|||
| (مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: | + | <noinclude>{{DISPLAYTITLE: الدالة <code>onEach()</code> في Kotlin}}</noinclude> |
| − | تطبّق الدالة <code>onEach()</code> | + | تطبّق الدالة <code>onEach()</code> دالةً محددةً على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استٌدعيت معها، ثم تعيد تلك [[Kotlin/CharSequence/index|السلسلة]]. |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 6: | سطر 6: | ||
action: (Char) -> Unit | action: (Char) -> Unit | ||
): S | ): S | ||
| − | </syntaxhighlight>'''بيئة التشغيل المطلوبة: Kotlin 1.1''' | + | </syntaxhighlight>'''بيئة التشغيل المطلوبة:''' Kotlin 1.1'''.''' |
| − | + | وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). | |
| + | |||
| + | == المعاملات == | ||
| + | |||
| + | === <code>action</code> === | ||
| + | الدالة المراد تطبيقها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة. يمرر إلى الدالة كل محرف على حدة ثم تعيد قيمة مقابلة له. | ||
==القيم المعادة== | ==القيم المعادة== | ||
| − | [[Kotlin/CharSequence | + | تعاد [[Kotlin/CharSequence|سلسلة من المحارف]] نفسها المعطاة تحوي القيمة المقابلة لكل محرف من محارفها والناتجة عن تطبيق الدالة <code>action</code>. |
==أمثلة== | ==أمثلة== | ||
| − | + | مثالٌ على استعمال الدالة <code>onEach()</code>:<syntaxhighlight lang="kotlin"> | |
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | val str = "Hsoub" | + | val str = "Hsoub" |
| − | str.onEach {print("$it ")} // H s o u b | + | str.onEach { print("$it|") } // H|s|o|u|b| |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
| − | *<code>[[Kotlin/kotlin.text/ | + | * الدالة <code>[[Kotlin/kotlin.text/map|map()]]</code>: تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها. |
| − | |||
==مصادر== | ==مصادر== | ||
| − | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/on-each.html صفحة الدالة | + | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/on-each.html صفحة الدالة CharSequence.onEach() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
| − | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
| + | [[تصنيف:Kotlin Text]] | ||
| + | [[تصنيف:Kotlin CharSequence]] | ||
المراجعة الحالية بتاريخ 15:57، 4 سبتمبر 2018
تطبّق الدالة onEach() دالةً محددةً على كل محرف من محارف السلسلة التي استٌدعيت معها، ثم تعيد تلك السلسلة.
البنية العامة
inline fun <S : CharSequence> S.onEach(
action: (Char) -> Unit
): S
بيئة التشغيل المطلوبة: Kotlin 1.1.
وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).
المعاملات
action
الدالة المراد تطبيقها على كل محرف من محارف السلسلة المعطاة. يمرر إلى الدالة كل محرف على حدة ثم تعيد قيمة مقابلة له.
القيم المعادة
تعاد سلسلة من المحارف نفسها المعطاة تحوي القيمة المقابلة لكل محرف من محارفها والناتجة عن تطبيق الدالة action.
أمثلة
مثالٌ على استعمال الدالة onEach():
fun main(args: Array<String>) {
val str = "Hsoub"
str.onEach { print("$it|") } // H|s|o|u|b|
}
انظر أيضًا
- الدالة
map(): تعيد قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها.