|
|
| (مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين) |
| سطر 1: |
سطر 1: |
| <noinclude>{{DISPLAYTITLE: الثابتة text.CASE_INSENSITIVE_ORDER في لغة Kotlin}}</noinclude> | | <noinclude>{{DISPLAYTITLE: الخاصية <code>CASE_INSENSITIVE_ORDER</code> في 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. |
| ==القيم المعادة== | | ==القيم المعادة== |
| [[Kotlin/List|لائحة]].
| | يعاد مُقارِن (Comparator) يرتب [[Kotlin/String|السلاسل النصية]] دون أخذ حالة الحروف (character case) بالحسبان. |
| ==أمثلة==
| |
| ===استخدام الدالة <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/text/toUpperCase|toUpperCase()]]</code> : تحوّل الدالة <code>toUpperCase()</code> الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase). | | == انظر أيضًا == |
| *<code>[[Kotlin/kotlin.text/toBigDecimal|toBigDecimal()]]</code>: تحلّل الدالة <code>toBigDecimal()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>. | | * الدالة <nowiki/>[[Kotlin/text/isLowerCase|<code>isLowerCase()</code>]]: تتحقق إن كان <nowiki/>[[Kotlin/Char|الحرف]] الذي استٌدعي معها حرفًا صغيرًا (lower case). |
| | * الدالة <nowiki/>[[Kotlin/text/isUpperCase|<code>isUpperCase()</code>]]: تتحقق إن كان <nowiki/>[[Kotlin/Char|الحرف]] الذي استٌدعي معها حرفًا كبيرًا (upper case). |
| | * الدالة <code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code> : تحوّل الحرف أو جميع حروف السلسلة النصية التي استٌدعيت معها إلى حروف كبيرة (uppercase). |
|
| |
|
| *<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 صفحة الخاصية CASE_INSENSITIVE_ORDER في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
| [[تصنيف:Kotlin]] | | [[تصنيف:Kotlin]] |
| [[تصنيف:Kotlin Method]] | | [[تصنيف:Kotlin Function]] |
| | [[تصنيف:Kotlin Text]] |
تعيد الخاصية CASE_INSENSITIVE_ORDER مُقارِنًا (Comparator) يرتب السلاسل النصية دون أخذ حالة الحروف (character case) بالحسبان.
تذكر أنّ هذا المُقارِن لا يأخذ إعدادات المحلية بالحسبان، وقد تنتج عن استخدامه نتائج غير مرضية في لمحليَّات معينة.
البنية العامة
val String.Companion.CASE_INSENSITIVE_ORDER: Comparator<String>
الإصدار المطلوب: JVM.
القيم المعادة
يعاد مُقارِن (Comparator) يرتب السلاسل النصية دون أخذ حالة الحروف (character case) بالحسبان.
انظر أيضًا
- الدالة
isLowerCase(): تتحقق إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case).
- الدالة
isUpperCase(): تتحقق إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case).
- الدالة
toUpperCase() : تحوّل الحرف أو جميع حروف السلسلة النصية التي استٌدعيت معها إلى حروف كبيرة (uppercase).
مصادر