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