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

مراجعة 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()‎: تقارن بين سلسلتين نصيتين.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <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">
-operator fun CharSequence.contains(
+fun String.endsWith(
-     other: CharSequence,
+     suffix: String,
      ignoreCase: Boolean = false
 ): Boolean
-operator fun CharSequence.contains(
+fun CharSequence.endsWith(
      char: Char,
      ignoreCase: Boolean = false
-): Boolean
-inline operator fun CharSequence.contains(
-    regex: Regex
 ): 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">
 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>
-===انظر أيضًا===
+==انظر أيضًا==
-* <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/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 Functions]]