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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.endsWith()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>endsWith()‎</code> القيمة <c...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>text.endsWith()‎</code> في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>text.endsWith()‎</code> في لغة Kotlin}}</noinclude>
−
تعيد الدالة <code>endsWith()‎</code> القيمة <code>true</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها تحتوي [[Kotlin/Char/index|الحرف]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]]  المُمرّرة. الوسيط <code>ignoreCase</code> يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف. 
+
تعيد الدالة <code>endsWith()‎</code> القيمة <code>true</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] أو [[Kotlin/String|السلسلة النصية]]  التي استُدعيت عبرها تنتهي بالحرف أو اللاحقة المُمرّرة. الوسيط <code>ignoreCase</code> يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.   
−
 
 
−
في حال تمرير [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] فستعيد الدالةُ القيمة <code>true</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها تحتوي على الأقل مطابقة واحدة لذلك [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]].   
 
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
−
operator fun CharSequence.contains(
+
fun String.endsWith(
−
     other: CharSequence,  
+
     suffix: String,  
 
     ignoreCase: Boolean = false
 
     ignoreCase: Boolean = false
 
): Boolean
 
): Boolean
  
−
operator fun CharSequence.contains(
+
fun CharSequence.endsWith(
 
     char: Char,  
 
     char: Char,  
 
     ignoreCase: Boolean = false
 
     ignoreCase: Boolean = false
−
): Boolean
 
−
 
−
inline operator fun CharSequence.contains(
 
−
    regex: Regex
 
 
): Boolean
 
): Boolean
−
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
  
 +
fun CharSequence.endsWith(
 +
    suffix: CharSequence,
 +
    ignoreCase: Boolean = false
 +
): Boolean
 +
</syntaxhighlight>
 
==القيم المعادة==
 
==القيم المعادة==
 
قيمة منطقية.  
 
قيمة منطقية.  
سطر 26: سطر 24:
 
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()endsWith</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()endsWith</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
−
    val str = "hsoub"
+
val str = "wiki Hsoub"  
−
 
+
   
−
    println(str.contains("sou")) // => true
+
println(str.endsWith("abc")) //  false
 +
println(str.endsWith("soub")) // true
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
−
===انظر أيضًا===
+
==انظر أيضًا==
−
* <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.
+
* <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]‎</code>: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>. 
  
 
* <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
 
* <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
−
* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 
  
 
==مصادر==
 
==مصادر==
−
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/contains.html الدالة text.endsWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/ends-with.html الدالة text.endsWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

مراجعة 18:20، 8 يوليو 2018

تعيد الدالة endsWith()‎ القيمة true إن كانت سلسلة الحروف أو السلسلة النصية التي استُدعيت عبرها تنتهي بالحرف أو اللاحقة المُمرّرة. الوسيط ignoreCase يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.

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

fun String.endsWith(
    suffix: String, 
    ignoreCase: Boolean = false
): Boolean

fun CharSequence.endsWith(
    char: Char, 
    ignoreCase: Boolean = false
): Boolean

fun CharSequence.endsWith(
    suffix: CharSequence, 
    ignoreCase: Boolean = false
): Boolean

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

قيمة منطقية.

أمثلة

استخدام الدالة ()endsWith مع سلسلة نصية

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

fun main(args: Array<String>) {
val str = "wiki Hsoub" 
    
println(str.endsWith("abc")) //  false	
println(str.endsWith("soub")) //  true	
}

انظر أيضًا

  • elementAt()‎: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء IndexOutOfBoundsException. 
  • compareTo()‎: تقارن بين سلسلتين نصيتين.

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/endsWith&oldid=12492"