الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/elementAtOrElse»

مراجعة 05:19، 3 سبتمبر 2018

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

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

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

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

المعاملات

`index`

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

`defaultValue`

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

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

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

أمثلة

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

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

    println(str.elementAtOrElse(10) { it.toChar() }) // 
}

انظر أيضًا

الدالة elementAt()‎: تجلب محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها.
الدالة elementAtOrNull()‎: تجلب محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها.
الدالة dropLast()‎: تُزيِل آخر n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.

مصادر

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

@@ سطر 35: / سطر 35: @@
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/element-at-or-else.html صفحة الدالة Text.elementAtOrElse()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/element-at-or-else.html صفحة الدالة CharSequence.elementAtOrElse()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]
 [[تصنيف:Kotlin Text]]
 [[تصنيف:Kotlin CharSequence]]