الدالة CharSequence.getOrElse()‎ في Kotlin

تجلب الدالة getOrElse()‎ محرفًا ذا فهرس مُحدَّد من سلسلة المحارف التي استُدعيت معها. إن كان الفهرس المعطى يقع خارج حدود سلسلة المحارف، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة.

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

inline fun CharSequence.getOrElse(
    index: Int, 
    defaultValue: (Int) -> Char
): Char

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

المعاملات

index

عدد صحيح يمثل فهرس المحرف المراد جلبه.

defaultValue

دالةٌ تُستدعَى عندما يقع الفهرس index خارج حدود سلسلة المحارف.

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

يعاد المحرف ذو الفهرس index من سلسلة المحارف المعطاة، أو ناتج استدعاء الدالة defaultValue إن كان الفهرس المعطى يقع خارج حدود سلسلة المحارف تلك.

أمثلة

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

fun main(args: Array<String>) {
    val str = "Hsoub"

    print(str.getOrElse(3) { it.toChar() }) // => u
    print(str.getOrElse(5) { '-' }) // => -
}

انظر أيضًا

• الدالة getOrNull()‎: تجلب محرفًا ذا فهرس مُحدَّد من سلسلة المحارف التي استُدعيت معها أو تعيد القيمة null إن كان الفهرس المعطى يقع خارج حدود سلسلة المحارف.  

• الدالة elementAtOrElse()‎: تجلب محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها.
• الدالة filter()‎: ترشِّح محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.

مصادر

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