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