الدالة onEach()‎ في Kotlin

من موسوعة حسوب
< Kotlin‏ | kotlin.text
مراجعة 15:47، 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|
}

انظر أيضًا

  • mapTo(): تضيف إلى المجموعة المتغيرة المُمرّرة destination نتائج تطبيق الدالة transform على عناصر سلسلة الحروف التي استٌدعيت عبرها.
  • mapIndexed(): تعيد لائحة مكونة من نتائج تطبيق الدالة transform المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها وعلى فهارسها.

مصادر