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

مراجعة 09:35، 10 يوليو 2018

تعيد الدالة last()‎ آخر حروف في سلسلة الحروف التي استٌدعيت عبرها، وفي حال تمرير شرط منطقي فستعيد آخر حروف يحقق ذلك الشرط.

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

fun CharSequence.last(): Char (source)

inline fun CharSequence.last(
    predicate: (Char) -> Boolean
): Char

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

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

حرف.

أمثلة

استخدام الدالة `last()‎` مع السلاسل النصية

تُعرّف الشيفرة الآتية سلسلة نصية باسم str، ثم تستدعي الدالة last()‎ عبرها مرة بدون وسيط ومرة بتمرير دالة منطقية كوسيط، ثم تطبع الناتج:

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

    print(str.last()) // b 
    print( str.last { it.isUpperCase() } ) // U
}

انظر أيضًا

isEmpty()‎: تعيد الدالة isEmpty()‎ القيمة true في حال كانت سلسلة الحروف التي استٌدعيت عبرها فارغة.
isHighSurrogate()‎: تعيد القيمة true في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: التابع text.last()‎ في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>last()</code>‎ القيمة <code>true</code> في حال كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها تساوي null أو فارغة.
+تعيد الدالة <code>last()</code>‎ آخر حروف في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها، وفي حال تمرير شرط منطقي فستعيد آخر حروف يحقق ذلك الشرط.
-== البنية العامة ==
+==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun CharSequence?.isNullOrEmpty(): Boolean
+fun CharSequence.last(): Char (source)
+inline fun CharSequence.last(
+    predicate: (Char) -> Boolean
+): Char
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inlinشe</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
-== القيم المعادة ==
+==القيم المعادة==
-قيمة منطقية.
+[[Kotlin/Char/index|حرف]].
+==أمثلة==
-== أمثلة ==
+===استخدام الدالة <code>last()‎</code> مع السلاسل النصية===
+تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>last()‎</code> عبرها مرة بدون وسيط ومرة بتمرير دالة منطقية كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <code>last()‎</code> مع السلاسل النصية ===
-تُعرّف الشيفرة الآتية ثلاث [[Kotlin/String|سلاسل نصية]] باسماء <code>str</code> و <code>str2</code> و <code>str3</code>، ثم تستدعي الدالة <code>last()‎</code> عبرها، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val str = "hsoub"
+     val str = "hsoUb"
-    val str2 = null
-    val str3 = ""
-    print(str.isNullOrEmpty()) // false
-    print(str2.isNullOrEmpty()) // true
-    print(str3.isNullOrEmpty()) // true
+    print(str.last()) // b
+    print( str.last { it.isUpperCase() } ) // U
 }
 </syntaxhighlight>
-== انظر أيضًا ==
+==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/isEmpty|isEmpty()]]‎</code>: تعيد الدالة <code>isEmpty()</code>‎ القيمة <code>true</code> في حال كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها فارغة.
+*<code>[[Kotlin/kotlin.text/isEmpty|isEmpty()]]‎</code>: تعيد الدالة <code>isEmpty()</code>‎ القيمة <code>true</code> في حال كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها فارغة.
-* <code>[[Kotlin/text/isHighSurrogate|isHighSurrogate()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
+*<code>[[Kotlin/text/isHighSurrogate|isHighSurrogate()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+*<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+==مصادر==
-== مصادر ==
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/last.html صفحة الدالة text.last()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-null-or-empty.html صفحة الدالة text.last()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]