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

المراجعة الحالية بتاريخ 16:58، 4 سبتمبر 2018

تعيد الدالة commonPrefixWith()‎ أطول بادئة (prefix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها. تأخذ الدالة بالحسبان ألا تقتطع الأزواج البديلة (surrogate pairs) عند جلب البادئة المشتركة تلك.

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

fun CharSequence.commonPrefixWith(
    other: CharSequence, 
    ignoreCase: Boolean = false
): String

المعاملات

`Other`

سلسلة المحارف التي يراد جلب البادئة المشتركة بينها وبين سلسلة المحارف المعطاة.

`ignoreCase`

قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء البحث عن بادئة مشتركة. القيمة الافتراضية هي: false أي أخذ حالة الحروف بالحسبان.

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

تعاد سلسلة نصية تحوي أطول بادئة (prefix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف other، أو تعاد سلسلة نصية فارغة إن لم يكن بين هاتين السلسلتين بادئة مشتركة.

أمثلة

مثالٌ على استعمال الدالة ()commonPrefixWith:

fun main(args: Array<String>) {
    val str = "win32"

    println(str.commonPrefixWith("win64")) // => win 
}

انظر أيضًا

الدالة commonSuffixWith()‎: تعيد أطول لاحقة (Suffix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها.
الدالة padStart()‎: تحشو بداية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.
الدالة startsWith()‎: تتحقق إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.
الدالة contains()‎: تتحقق إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها.

مصادر

صفحة الدالة CharSequence.commonPrefixWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.commonPrefixWith()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.commonPrefixWith()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>commonPrefixWith()‎</code> عدد أكواد اليونيكود (Unicode code point) في المجال المُحدّد من النص.
+تعيد الدالة <code>commonPrefixWith()‎</code> أطول بادئة (prefix) مُشتركة بين [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها. تأخذ الدالة بالحسبان ألا تقتطع الأزواج البديلة (surrogate pairs) عند جلب البادئة المشتركة تلك.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun String.codePointCount(
+fun CharSequence.commonPrefixWith(
-     beginIndex: Int,
+     other: CharSequence,
-     endIndex: Int
+     ignoreCase: Boolean = false
-): Int
+): String
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>
+== المعاملات ==
+=== <code>Other</code> ===
+سلسلة المحارف التي يراد جلب البادئة المشتركة بينها وبين سلسلة المحارف المعطاة.
+=== <code>ignoreCase</code> ===
+قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء البحث عن بادئة مشتركة. القيمة الافتراضية هي: <code>false</code> أي أخذ حالة الحروف بالحسبان.
 ==القيم المعادة==
-عدد من النوع <code>Int</code>.
+تعاد [[Kotlin/String|سلسلة نصية]] تحوي أطول بادئة (prefix) مُشتركة بين [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] <code>other</code>، أو تعاد سلسلة نصية فارغة إن لم يكن بين هاتين السلسلتين بادئة مشتركة.
 ==أمثلة==
-===استخدام الدالة <code>()commonPrefixWith</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()commonPrefixWith</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()codePointCount</code> عبرها مع تمرير عددين كوسيطين، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val str = "hsoub Academy"
+     val str = "win32"
-     println(str.codePointCount(2,8)) // => 6
+     println(str.commonPrefixWith("win64")) // => win
 }
 </syntaxhighlight>
-===انظر أيضًا===
+==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.
+* الدالة <code>[[Kotlin/kotlin.text/commonSuffixWith|commonSuffixWith()]]‎</code>: تعيد  أطول لاحقة (Suffix) مُشتركة بين [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.
+* الدالة <code>[[Kotlin/kotlin.text/padStart|padStart()]]‎</code>: تحشو بداية [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد.
-* <code>[[Kotlin/kotlin.text/codePointBefore|codePointBefore()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد.
+* الدالة <code>[[Kotlin/kotlin.text/startsWith|startsWith()]]‎</code>: تتحقق إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
+* الدالة <code>[[Kotlin/kotlin.text/contains|contains()‎]]</code>: تتحقق إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تحوي <nowiki/>[[Kotlin/Char|المحرف]] أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/code-point-count.html الدالة text.commonPrefixWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/common-prefix-with.html صفحة الدالة CharSequence.commonPrefixWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]