الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/commonPrefixWith»
< Kotlin | kotlin.text
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>text.commonPrefixWith()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>text.commonPrefixWith()</code> في لغة Kotlin}}</noinclude> | ||
تعيد الدالة <code>commonPrefixWith()</code> أكبر سابقة مُشتركة بين [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] المُمرّرة، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). | تعيد الدالة <code>commonPrefixWith()</code> أكبر سابقة (<code>prefix</code>) مُشتركة بين [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] المُمرّرة، وفي حال إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</code> فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). الدالة أيضًا لا تُقسّم الأزواج البديلة (surrogate pairs)، وإن لم تكن بينهما سابقة مشتركة فستعيد [[Kotlin/String|سلسلة نصية]] فارغة. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 20: | سطر 20: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===انظر أيضًا=== | ===انظر أيضًا=== | ||
* <code>[[Kotlin/kotlin.text/ | * <code>[[Kotlin/kotlin.text/commonSuffixWith|commonSuffixWith()]]</code>: تعيد أكبر لاحقة (suffix) مُشتركة بين [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] المُمرّرة، وفي حال إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</code> فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). الدالة أيضًا لا تُقسّم الأزواج البديلة (surrogate pairs)، وإن لم تكن بينهما لاحقة مشتركة فستعيد [[Kotlin/String|سلسلة نصية]] فارغة. | ||
* <code>[[Kotlin/kotlin.text/codePointBefore|codePointBefore()]]</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد. | * <code>[[Kotlin/kotlin.text/codePointBefore|codePointBefore()]]</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد. | ||
مراجعة 12:07، 8 يوليو 2018
تعيد الدالة commonPrefixWith() أكبر سابقة (prefix) مُشتركة بين سلسلة الحروف التي استُدعيت عبرها وسلسلة الحروف المُمرّرة، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). الدالة أيضًا لا تُقسّم الأزواج البديلة (surrogate pairs)، وإن لم تكن بينهما سابقة مشتركة فستعيد سلسلة نصية فارغة.
البنية العامة
fun CharSequence.commonPrefixWith(
other: CharSequence,
ignoreCase: Boolean = false
): String
القيم المعادة
أمثلة
استخدام الدالة ()commonPrefixWith مع سلسلة نصية
تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة (commonPrefixWith عبرها مع تمرير سلسلة نصية كوسيط، ثمَّ تطبع الناتج:
fun main(args: Array<String>) {
val str = "win32"
println(str.commonPrefixWith("win64")) // => win
}
انظر أيضًا
commonSuffixWith(): تعيد أكبر لاحقة (suffix) مُشتركة بين سلسلة الحروف التي استُدعيت عبرها وسلسلة الحروف المُمرّرة، وفي حال إعطاء القيمةtrueللوسيطignoreCaseفستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). الدالة أيضًا لا تُقسّم الأزواج البديلة (surrogate pairs)، وإن لم تكن بينهما لاحقة مشتركة فستعيد سلسلة نصية فارغة.
codePointBefore(): تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد.asSequence(): تنشئ كائنًا من الصنفSequenceوالذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.