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

تجلب الدالة takeWhile()‎ أول عناصر محققة لشرطٍ محدَّدٍ من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.

البنية العامة

inline fun CharSequence.takeWhile(
    predicate: (Char) -> Boolean
): CharSequence
inline fun String.takeWhile(
    predicate: (Char) -> Boolean
): String

يُلاحَظ وجود الكلمة المفتاحية inline التي تدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).

المعاملات

predicate

دالةٌ تطبق على كل محرف من محارف سلسلة المحارف أو السلسلة النصية المعطاة. يمرر إليها كل محرف على حدة ثم تعيد قيمة منطقية مقابلة له.

القيم المعادة

تعاد سلسلة من المحارف أو سلسلة نصية تحوي العناصر الأولى المحققة للشرط predicate المعطى من سلسلة المحارف أو السلسلة النصية المعطاة.

أمثلة

مثالٌ على استعمال الدالة ()takeWhile:

fun main(args: Array<String>) {
    val str = "Wiki.Wsoub.Wom"

    println(str.takeWhile { it.isLetter() }) // Wiki
    println(str.takeWhile { it.isUpperCase() }) // W
}

انظر أيضًا

• الدالة take()‎: تجلب أول n محرف من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.  
• الدالة takeLast()‎: تجلب آخر n محرف من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.
• الدالة takeLastWhile()‎: تجلب آخر عناصر محققة لشرطٍ محدَّدٍ من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.
• الدالة substring()‎: تعيد جزءًا محددًا من السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.
• الدالة slice()‎: تقتطع جزءًا محدَّدًا من سلسلة المحارف أو السلسلة النصية  التي استُدعيت معها ثمَّ تعيده.
• الدالة split()‎: تقتطع المحارف الموجودة بين الأجزاء المتطابقة مع تعبير نمطي معين أو بين سلاسل نصية أو محارف معينة في سلسلة المحارف الممررة إليها وتعيدها في قائمة.
• الدالة substringAfter()‎: تجلب كل الجزء الواقع بعد أول ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية.

مصادر

• صفحة الدالة takeWhile()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.