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

مراجعة 13:01، 2 سبتمبر 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()‎ إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها.
الدالة commonPrefixWith()‎: تعيد أطول بادئة (prefix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.compareTo()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>String.compareTo()‎</code> في Kotlin}}</noinclude>
-تقارن الدالة <code>compareTo()‎</code> بين [[Kotlin/String|سلسلتين نصيتين]]، مع إمكانية تجاهل حالة الأحرف عبر إعطاء القيمة <code>true</code>  للوسيط <code>ignoreCase</code>.
+توازن الدالة <code>compareTo()‎</code> بين [[Kotlin/String|سلسلتين نصيتين]] معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 7: / سطر 7: @@
      ignoreCase: Boolean = false
 ): Int
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>other</code> ===
+السلسلة النصية المراد موازنتها مع السلسلة النصية المعطاة.
+=== <code>ignoreCase</code> ===
+قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء الموازنة. القيمة الافتراضية هي: <code>false</code> أي أخذ حالة الحروف بالحسبان.
 ==القيم المعادة==
-عدد من النوع <code>Int</code>.
+تعاد القيمة 0 إن كانت السلسلتان النصيتان متساويتن، أو قيمة موجبة إن كانت السلسلة النصية الأولى أكبر من السلسلة النصية الثانية (أي السلسلة <code>ohter</code>)، أو قيمة سالبة إن كانت السلسلة النصية الثانية أكبر من السلسلة النصية الأولى.
 ==أمثلة==
-===استخدام الدالة <code>()compareTo</code> مع سلسلة نصية===
+استعمال الدالة <code>()compareTo</code> للموازنة بين سلسلتين نصيتين<nowiki/><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()compareTo</code> عبرها مع تمرير [[Kotlin/String|سلسلة نصية]]<nowiki/>كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val str = "abcd"
@@ سطر 20: / سطر 27: @@
 }
 </syntaxhighlight>
-===انظر أيضًا===
+==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.
+* الدالة <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/codePointBefore|codePointBefore()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد.
+* الدالة <code>[[Kotlin/kotlin.text/codePointAt|commonPrefixWith()]]‎</code>: تعيد أطول بادئة (prefix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/compare-to.html الدالة text.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/compare-to.html صفحة الدالة String.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin String]]