الفرق بين المراجعتين ل"Kotlin/kotlin.text/lastOrNull"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.lastOrNull()</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>lastOrNull()</code> Kotlin/Ch...') |
|||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>text.lastOrNull()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>text.lastOrNull()</code> في لغة Kotlin}}</noinclude> | ||
− | تعيد الدالة <code>lastOrNull()</code> [[Kotlin/Char/index|الحرف]] | + | تعيد الدالة <code>lastOrNull()</code> [[Kotlin/Char/index|الحرف]] الأخير من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية <code>predicate</code> كوسيط فستعيد [[Kotlin/Char/index|الحرف]] الأخير الذي يحقق الشرط المنطقي <code>predicate</code>. |
تعيد الدالة <code>first()</code> القيمة <code>null</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] فارغة أو لم يكن هناك أي حرف يحقق الشرط المنطقي <code>predicate</code>. | تعيد الدالة <code>first()</code> القيمة <code>null</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] فارغة أو لم يكن هناك أي حرف يحقق الشرط المنطقي <code>predicate</code>. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
− | fun CharSequence. | + | fun CharSequence.lastOrNull(): Char? |
− | inline fun CharSequence. | + | inline fun CharSequence.lastOrNull( |
predicate: (Char) -> Boolean | predicate: (Char) -> Boolean | ||
− | ): Char? | + | ): Char? |
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
سطر 20: | سطر 20: | ||
تعرِّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة <code>()lastOrNull</code> عبرها مع تمرير دالة منطقية كوسيط، كما تستدعيها كذلك عبر [[Kotlin/String|سلسلة نصية]] فارغة، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin"> | تعرِّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة <code>()lastOrNull</code> عبرها مع تمرير دالة منطقية كوسيط، كما تستدعيها كذلك عبر [[Kotlin/String|سلسلة نصية]] فارغة، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
− | val str = " | + | val str = "Hsoub Wiki" |
− | println(str. | + | println(str.lastOrNull {it.isUpperCase()} ) // W |
− | println("". | + | println("".lastOrNull () ) // null |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
سطر 35: | سطر 35: | ||
==مصادر== | ==مصادر== | ||
− | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/ | + | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/last-or-null.html الدالة text.lastOrNull() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] |
مراجعة 10:00، 10 يوليو 2018
تعيد الدالة lastOrNull()
الحرف الأخير من سلسلة الحروف التي استُدعيت عبرها، وفي حال تمرير دالة منطقية predicate
كوسيط فستعيد الحرف الأخير الذي يحقق الشرط المنطقي predicate
.
تعيد الدالة first()
القيمة null
إن كانت سلسلة الحروف فارغة أو لم يكن هناك أي حرف يحقق الشرط المنطقي predicate
.
البنية العامة
fun CharSequence.lastOrNull(): Char?
inline fun CharSequence.lastOrNull(
predicate: (Char) -> Boolean
): Char?
يُلاحَظ وجود الكلمة المفتاحية inline
للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
حرف أو null
.
أمثلة
استخدام الدالة ()lastOrNull
مع سلسلة نصية
تعرِّف الشيفرة الآتية سلسلة نصية باسم str
، ثمَّ تستدعي الدالة ()lastOrNull
عبرها مع تمرير دالة منطقية كوسيط، كما تستدعيها كذلك عبر سلسلة نصية فارغة، ثمَّ تطبع الناتج:
fun main(args: Array<String>) {
val str = "Hsoub Wiki"
println(str.lastOrNull {it.isUpperCase()} ) // W
println("".lastOrNull () ) // null
}
انظر أيضًا
first()
: تعيد الحرف الأول من سلسلة الحروف التي استُدعيت عبرها، وفي حال تمرير دالة منطقيةpredicate
كوسيط فستعيد الحرف الأول الذي يحقق الشرط المنطقيpredicate
.find()
: تعيد أول حرف من سلسلة الحروف التي استُدعيت عبرها يحقق الشرط المنطقيpredicate.
filterIndexed()
: تعيد الدالةfilterIndexed()
كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالةpredicate()
ثم تعيد بدورها قيمة منطقيَّة.
elementAt()
: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناءIndexOutOfBoundsException
.