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

مراجعة 12:13، 8 يوليو 2018

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

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

fun String.compareTo(
    other: String, 
    ignoreCase: Boolean = false
): Int

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

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

عدد من النوع Int.

أمثلة

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

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

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

    println(str.compareTo("abch")) // => -4 
}

انظر أيضًا

codePointAt()‎: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.

codePointBefore()‎: تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد.
asSequence()‎: تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.compareTo()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>compareTo()‎</code> عدد أكواد اليونيكود (Unicode code point) في المجال المُحدّد من النص.
+تقارن الدالة <code>compareTo()‎</code> بين [[Kotlin/String|سلسلتين نصيتين]]، مع إمكانية تجاهل حالة الأحرف عبر إعطاء القيمة <code>true</code>  للوسيط <code>ignoreCase</code>.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun String.codePointCount(
+fun String.compareTo(
-     beginIndex: Int,
+     other: String,
-     endIndex: Int
+     ignoreCase: Boolean = false
 ): Int
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
@@ سطر 13: / سطر 13: @@
 ==أمثلة==
 ===استخدام الدالة <code>()compareTo</code> مع سلسلة نصية===
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()compareTo</code> عبرها مع تمرير عددين كوسيطين، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()compareTo</code> عبرها مع تمرير [[Kotlin/String|سلسلة نصية]]<nowiki/>كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val str = "hsoub Academy"
+     val str = "abcd"
-     println(str.codePointCount(2,8)) // => 6
+     println(str.compareTo("abch")) // => -4
 }
 </syntaxhighlight>
@@ سطر 27: / سطر 27: @@
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/code-point-count.html الدالة text.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/compare-to.html الدالة text.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]