الفرق بين المراجعتين ل"Kotlin/kotlin.text/last"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.last()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>last()</code>‎ القيمة <code>true</code> في...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: التابع text.last()‎ في لغة Kotlin}}</noinclude>
 
<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">
 
<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)]].
 
</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>) {     
 
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>
 
</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]]
 
[[تصنيف:Kotlin Method]]
 
[[تصنيف:Kotlin Method]]

مراجعة 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).

مصادر