الفرق بين المراجعتين لصفحة: «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.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.compareTo()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>String.compareTo()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>compareTo()‎</code> عدد أكواد اليونيكود (Unicode code point) في المجال المُحدّد من النص.
+توازن الدالة <code>compareTo()‎</code> بين [[Kotlin/String|سلسلتين نصيتين]] معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
 ==البنية العامة==
 <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)]].
+</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> عبرها مع تمرير عددين كوسيطين، <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>
-===انظر أيضًا===
+==انظر أيضًا==
-* <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) للحرف الموجود قبل الفهرس المُحدّد.
+* الدالة [[Kotlin/kotlin.text/equals|<code>equals()</code>‎]]: تتحقق من تساوي [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/Char|المحرف]] الذي استُدعي معها مع [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/Char|المحرف]] المُمرّر إليها مع إمكانية تجاهل حالة المحارف.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 ==مصادر==
-*[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 صفحة الدالة String.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin String]]