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

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

توازن الدالة compareTo()‎ بين سلسلتين نصيتين معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.

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

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

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

المعاملات

`other`

السلسلة النصية المراد موازنتها مع السلسلة النصية المعطاة.

`ignoreCase`

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

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

تعاد القيمة 0 إن كانت السلسلتان النصيتان متساويتن، أو قيمة موجبة إن كانت السلسلة النصية الأولى أكبر من السلسلة النصية الثانية (أي السلسلة ohter)، أو قيمة سالبة إن كانت السلسلة النصية الثانية أكبر من السلسلة النصية الأولى.

أمثلة

استعمال الدالة ()compareTo للموازنة بين سلسلتين نصيتين:

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

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

انظر أيضًا

الدالة contentEquals()‎: تتحقق من تساوي محتوى السلسلة النصية التي استُدعيت معها مع محتوى سلسلة المحارف أو الكائن StringBuffer المُمرّر إليها.
الدالة contains()‎ إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها.
الدالة equals()‎: تتحقق من تساوي السلسلة النصية أو المحرف الذي استُدعي معها مع السلسلة النصية أو المحرف المُمرّر إليها مع إمكانية تجاهل حالة المحارف.

مصادر

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

@@ سطر 30: / سطر 30: @@
 * الدالة <code>[[Kotlin/kotlin.text/contentEquals|contentEquals()‎]]</code>: تتحقق من تساوي محتوى [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها مع محتوى [[Kotlin/CharSequence|سلسلة المحارف]] أو الكائن <code>[[Kotlin/kotlin.text/StringBuffer|StringBuffer]]</code> المُمرّر إليها.
 * الدالة <code>[[Kotlin/kotlin.text/contains|contains()‎]]</code> إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تحوي [[Kotlin/Char|المحرف]] أو [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها.
-* الدالة <code>[[Kotlin/kotlin.text/codePointAt|commonPrefixWith()]]‎</code>: تعيد أطول بادئة (prefix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.
+* الدالة [[Kotlin/kotlin.text/equals|<code>equals()</code>‎]]: تتحقق من تساوي [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/Char|المحرف]] الذي استُدعي معها مع [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/Char|المحرف]] المُمرّر إليها مع إمكانية تجاهل حالة المحارف.
 ==مصادر==