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

مراجعة 07:45، 14 يوليو 2018

تعيد الخاصية CASE_INSENSITIVE_ORDER‎ مُقارِنًا (Comparator) يرتب السلاسل النصية دون أخذ حالة الحروف (character case) بعين الاعتبار.

تذكر أنّ هذا المُقارِن لا يأخذ الإعدادات المحلية بعين الاعتبار، وقد تنتج عن استخدامه نتائج غير مرضية في بعد الحالات.

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

val String.Companion.CASE_INSENSITIVE_ORDER: Comparator<String>

بيئة التشغيل المطلوبة: JVM

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

مُقارِن (Comparator).

انظر أيضًا

zipWithNext()‎ : تتعيد الدالة zipWithNext()‎ لائحة تحتوي أزواجًا (pairs) مُركّبة من حروف سلسلة الحروف التي استٌدعيت عبرها ومن حروف السلسلة الأخرى المًمرّرة other التي عند الفهرس الموالي، اللائحة المُعادة ستكون فارغة إن كانت سلسلة حروف الأصلية تحتوي أقل من حرفين.

toUpperCase()‎ : تحوّل الدالة toUpperCase()‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
toBigDecimal()‎: تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع BigDecimal.

isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

صفحة الثابتة text.CASE_INSENSITIVE_ORDER في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الثابتة text.CASE_INSENSITIVE_ORDER‎ في لغة Kotlin}}</noinclude>
-يختلف سلوك الدالة <code>CASE_INSENSITIVE_ORDER</code>‎ بحسب نوع وعدد الوسائط المُمرّرة (انظر فقرة [[Kotlin/kotlin.text/zip#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]).
+تعيد الخاصية <code>CASE_INSENSITIVE_ORDER</code>‎ مُقارِنًا (Comparator) يرتب [[Kotlin/String|السلاسل النصية]] دون أخذ حالة الحروف (character case) بعين الاعتبار.
+تذكر أنّ هذا المُقارِن لا يأخذ الإعدادات المحلية بعين الاعتبار، وقد تنتج عن استخدامه نتائج غير مرضية في بعد الحالات.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-infix fun CharSequence.zip(
+val String.Companion.CASE_INSENSITIVE_ORDER: Comparator<String>
-    other: CharSequence
-): List<Pair<Char, Char>>
-</syntaxhighlight>تعيد الدالة <code>zip()</code>‎ [[Kotlin/List|لائحة]] تحتوي [[Kotlin/Pair/index|أزواجًا]] (pairs) مُركّبة من حروف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت عبرها ومن حروف السلسلة الأخرى المًمرّرة <code>other</code> التي لها نفس الفهرس، [[Kotlin/List|اللائحة]] المُعادة لها طول أقصر [[Kotlin/CharSequence/index|سلسلة حروف]].<syntaxhighlight lang="kotlin">
-inline fun <V> CharSequence.zip(
-    other: CharSequence,
-    transform: (a: Char, b: Char) -> V
-): List<V>
-</syntaxhighlight>تعيد الدالة <code>zip()</code>‎ [[Kotlin/List|لائحة]] تحتوي  نتائج تطبيق الدالة المُمرّرة <code>transform</code> على حروف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت عبرها وعلى حروف السلسلة الأخرى المًمرّرة <code>other</code> التي لها نفس الفهرس، [[Kotlin/List|اللائحة]] المُعادة لها طول أقصر [[Kotlin/CharSequence/index|سلسلة حروف]].
-يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>'''بيئة التشغيل المطلوبة: JVM'''
+==القيم المعادة==
+مُقارِن (Comparator).
-==القيم المعادة==
+== انظر أيضًا ==
-[[Kotlin/List|لائحة]].
-==أمثلة==
-===استخدام الدالة <code>zip()‎</code> مع السلاسل النصية===
-تستدعي الشيفرة الآتية الدالة <code>zip()‎</code> عبر عدة [[Kotlin/String|سلاسل نصية]] مع تمرير [[Kotlin/String|سلسلة نصية]] كوسيط، وتطبع الناتج:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-println("hsoub".zip("12345")) // [(h, 1), (s, 2), (o, 3), (u, 4), (b, 5)]
-println("hsoub".zip("12")) // [(h, 1), (s, 2)]
-println("hsoub" zip "HSOUB") // [(h, H), (s, S), (o, O), (u, U), (b, B)]
-}
-</syntaxhighlight>
-===استخدام الدالة <code>zip()‎</code> مع السلاسل النصية مع تمرير دالة===
-تستدعي الشيفرة الآتية الدالة <code>zip()‎</code> عبر عدة [[Kotlin/String|سلاسل نصية]] مع تمرير [[Kotlin/String|سلسلة نصية]] ودالة كوسيط، وتطبع الناتج:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-println("hsoub".zip("12345") {x, y -> listOf(x,y) }) // [[h, 1], [s, 2], [o, 3], [u, 4], [b, 5]]
-println("hsoub".zip("wiki") {x, y -> if (x > y) x else y }) // [w, s, o, u]
-}
-</syntaxhighlight>
-==انظر أيضًا==
 * <code>[[Kotlin/kotlin.text/zipWithNext|zipWithNext()]]</code>‎ : تتعيد الدالة <code>zipWithNext()</code>‎ [[Kotlin/List|لائحة]] تحتوي [[Kotlin/Pair/index|أزواجًا]] (pairs) مُركّبة من حروف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت عبرها ومن حروف السلسلة الأخرى المًمرّرة <code>other</code> التي عند الفهرس الموالي، [[Kotlin/List|اللائحة]] المُعادة ستكون فارغة إن  كانت [[Kotlin/CharSequence/index|سلسلة حروف]] الأصلية تحتوي أقل من حرفين.
@@ سطر 41: / سطر 19: @@
 *<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/zip.html صفحة الثابتة text.String.Companion.CASE_INSENSITIVE_ORDER في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-c-a-s-e_-i-n-s-e-n-s-i-t-i-v-e_-o-r-d-e-r.html صفحة الثابتة text.CASE_INSENSITIVE_ORDER في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]