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

مراجعة 18:56، 11 يوليو 2018

إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالة removePrefix()‎ تبدأ بالبادئة prefix فستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك البادئة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.

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

fun CharSequence.removePrefix(
    prefix: CharSequence
): CharSequence

إن كانت سلسلة الحروف التي استٌدعيت عبرها الدالة removePrefix()‎ تبدأ بالبادئة prefix فستعيد الدالةُ سلسلة حروف جديدة مع حذف تلك البادئة، وإلا فستعيد سلسلة الحروف كما هي.

fun String.removePrefix(prefix: CharSequence): String

إن كانت السلسلة النصية التي استٌدعيت عبرها الدالة removePrefix()‎ تبدأ بالبادئة prefix فستعيد سلسلة نصية جديدة مع حذف تلك البادئة، وإلا فستعيد السلسلة النصية كما هي.

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

سلسلة نصية أو سلسلة الحروف.

أمثلة

استخدام الدالة `()removePrefix` مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()removePrefix عبرها مع تمرير سلسلة نصية كوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
val str = "hsoub wiki" 
    
print( str.removePrefix ("hsoub ") ) // wiki
print( str.removePrefix ("xyz") ) // hsoub wiki
}

انظر أيضًا

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

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.removePrefix()‎</code> في لغة Kotlin}}</noinclude>
-تضم الدالة <code>removePrefix()‎</code> [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها إلى [[Kotlin/String|السلسلة النصية]] المُمرّرة وتعيد [[Kotlin/String|السلسلة النصية]] الناتجة.
+إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removePrefix()‎</code> تبدأ بالبادئة <code>prefix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun String.concat(str: String): String
+fun CharSequence.removePrefix(
+    prefix: CharSequence
+): CharSequence
+</syntaxhighlight>إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removePrefix()‎</code> تبدأ بالبادئة <code>prefix</code> فستعيد الدالةُ [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.<syntaxhighlight lang="kotlin">
+fun String.removePrefix(prefix: CharSequence): String
-</syntaxhighlight>'''بيئة التشغيل المطلوبة:  JS'''
+</syntaxhighlight>إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها الدالة <code>removePrefix()‎</code> تبدأ بالبادئة <code>prefix</code> فستعيد [[Kotlin/String|سلسلة نصية]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]]  كما هي.
-يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المعادة==
-[[Kotlin/String|سلسلة نصية]].
+[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]].
 ==أمثلة==
 ===استخدام الدالة <code>()removePrefix</code> مع سلسلة نصية===
 تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()removePrefix</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-    val str = "hsoub"
+val str = "hsoub wiki"
-    println(str.concat(" wiki")) // => hsoub wiki
+print( str.removePrefix ("hsoub ") ) // wiki
+print( str.removePrefix ("xyz") ) // hsoub wiki
 }
 </syntaxhighlight>
@@ سطر 27: / سطر 30: @@
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/concat.html الدالة text.removePrefix()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/remove-prefix.html الدالة text.removePrefix()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]