الفرق بين المراجعتين ل"Kotlin/kotlin.text/elementAtOrNull"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - 'Kotlin Functions' ب'Kotlin Function') |
|||
| سطر 30: | سطر 30: | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/element-at-or-null.html الدالة text.elementAtOrNull() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/element-at-or-null.html الدالة text.elementAtOrNull() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
| − | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
مراجعة 11:35، 30 أغسطس 2018
تعيد الدالة elementAtOrNull() الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، وفي حال كان الفهرس خارج الحدود فستعيد null.
البنية العامة
inline fun CharSequence.elementAtOrNull(index: Int): Char?
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
حرف.
أمثلة
استخدام الدالة ()elementAtOrNull مع سلسلة نصية
تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()elementAtOrNull عبرها مع تمرير عدد كوسيط، ثمَّ تطبع الناتج:
fun main(args: Array<String>) {
val str = "wiki Hsoub"
println(str.elementAtOrNull(2)) // k
println(str.elementAtOrNull(100)) // null
}
انظر أيضًا
elementAt(): تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناءIndexOutOfBoundsException.
elementAtOrElse():تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، وفي حال كان الفهرس خارج الحدود فستعيد ناتج تمرير ذلك الفهرس إلى الدالة المُمررةdefaultValue.asSequence(): تنشئ كائنًا من الصنفSequenceوالذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.