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

مراجعة 12:01، 8 يوليو 2018

تعيد الدالة commonPrefixWith()‎ أكبر سابقة مُشتركة بين سلسلة الحروف التي استُدعيت عبرها وسلسلة الحروف المُمرّرة، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة).

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

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 
}

انظر أيضًا

codePointAt()‎: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.

codePointBefore()‎: تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد.
asSequence()‎: تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.commonPrefixWith()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>commonPrefixWith()‎</code> عدد أكواد اليونيكود (Unicode code point) في المجال المُحدّد من النص.
+تعيد الدالة <code>commonPrefixWith()‎</code> أكبر سابقة مُشتركة بين [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] المُمرّرة، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة).
 ==البنية العامة==
 <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>Int</code>.
+[[Kotlin/String|سلسلة نصية]].
 ==أمثلة==
 ===استخدام الدالة <code>()commonPrefixWith</code> مع سلسلة نصية===
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()codePointCount</code> عبرها مع تمرير عددين كوسيطين، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>(commonPrefixWith</code> عبرها مع تمرير [[Kotlin/String|سلسلة نصية]] كوسيط، <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>
@@ سطر 27: / سطر 26: @@
 ==مصادر==
-*[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 الدالة text.commonPrefixWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]