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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.endsWith()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>endsWith()‎</code> القيمة <c...')
 
(مراجعة وتدقيق.)
 
(3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 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> إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة.   
 
 
في حال تمرير [[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
 +
): Boolean
 +
 +
fun CharSequence.endsWith(
 +
    suffix: CharSequence,
 
     ignoreCase: Boolean = false
 
     ignoreCase: Boolean = false
 
): Boolean  
 
): Boolean  
 +
</syntaxhighlight>
  
inline operator fun CharSequence.contains(
+
== المعاملات ==
    regex: Regex
+
 
): Boolean
+
=== <code>suffix</code> ===
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+
[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence|سلسلة من المحارف]] تمثل اللاحقة التي يراد التحقق من أنَّ [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة تنتهي بها.
 +
 
 +
=== <code>char</code> ===
 +
المحرف الذي يراد التأكد من وجوده في نهاية [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة.
 +
 
 +
=== <code>ignoreCase</code> ===
 +
قيمة منطقية تحدد إن كان يراد تجاهل حالة المحارف أم لا أثناء الموازنة. القيمة الافتراضية هي: <code>false</code> أي أخذ حالة الحروف بالحسبان.
  
 
==القيم المعادة==
 
==القيم المعادة==
قيمة منطقية.  
+
تعاد القيمة <code>true</code> إن كانت [[Kotlin/String|السلسلة النصية]] المعطاة تنتهي باللاحقة <code>suffix</code> أو كانت [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة تنتهي باللاحقة <code>suffix</code> أو بالمحرف <code>char</code>. خلا ذلك، تعاد القيمة <code>false</code>.  
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة <code>()endsWith</code> مع سلسلة نصية===
+
مثالٌ على استعمال الدالة <code>()endsWith</code><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 = "wikiHsoub"
  
     println(str.contains("sou")) // => true
+
     println(str.endsWith("wiki")) // false
 +
    println(str.endsWith("hsoub", true)) //  true
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
===انظر أيضًا===
+
==انظر أيضًا==
* <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.
+
* الدالة <code>[[Kotlin/kotlin.text/startsWith|startsWith()]]‎</code>: تتحقق إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.
 +
* الدالة <code>[[Kotlin/kotlin.text/commonSuffixWith|commonSuffixWith()]]‎</code>: تعيد أطول لاحقة (Suffix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.
  
* <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
+
* الدالة <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: توازن بين سلسلتين نصيتين معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
+
* الدالة <code>[[Kotlin/kotlin.text/contains|contains()]]</code> إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تحوي <nowiki/>[[Kotlin/Char|المحرف]] أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها.
  
 
==مصادر==
 
==مصادر==
*[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 صفحة الدالة endsWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]

المراجعة الحالية بتاريخ 05:16، 3 سبتمبر 2018

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

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

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

المعاملات

suffix

سلسلة نصية أو سلسلة من المحارف تمثل اللاحقة التي يراد التحقق من أنَّ السلسلة النصية أو سلسلة المحارف المعطاة تنتهي بها.

char

المحرف الذي يراد التأكد من وجوده في نهاية سلسلة المحارف المعطاة.

ignoreCase

قيمة منطقية تحدد إن كان يراد تجاهل حالة المحارف أم لا أثناء الموازنة. القيمة الافتراضية هي: false أي أخذ حالة الحروف بالحسبان.

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

تعاد القيمة true إن كانت السلسلة النصية المعطاة تنتهي باللاحقة suffix أو كانت سلسلة المحارف المعطاة تنتهي باللاحقة suffix أو بالمحرف char. خلا ذلك، تعاد القيمة false.

أمثلة

مثالٌ على استعمال الدالة ()endsWith:

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

    println(str.endsWith("wiki")) //  false
    println(str.endsWith("hsoub", true)) //  true
}

انظر أيضًا

مصادر