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

من موسوعة حسوب
التعديل اللاحق ←
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الثابتة text.CASE_INSENSITIVE_ORDER‎ في لغة Kotlin}}</noinclude> يختلف سلوك الدالة <code>CASE_INSENSITIVE_ORDER</...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الثابتة text.CASE_INSENSITIVE_ORDER‎ في لغة Kotlin}}</noinclude>
<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">
<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|سلسلة حروف]] الأصلية تحتوي أقل من حرفين.
* <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).
*<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]]
[[تصنيف:Kotlin Method]]
[[تصنيف:Kotlin Method]]

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

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

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

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

val String.Companion.CASE_INSENSITIVE_ORDER: Comparator<String>

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

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

مُقارِن (Comparator).

انظر أيضًا

  • toUpperCase()‎ : تحوّل الدالة toUpperCase()‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
  • toBigDecimal()‎: تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع BigDecimal.
  • isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/CASE_INSENSITIVE_ORDER&oldid=13067»