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

المراجعة الحالية بتاريخ 06:03، 5 سبتمبر 2018

تحذف الدالة removeSuffix()‎ لاحقة معينة من سلسلة من المحارف أو سلسلة نصية.

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

fun CharSequence.removeSuffix(
    suffix: CharSequence
): CharSequence

fun String.removeSuffix(suffix: CharSequence): String

المعاملات

`suffix`

سلسلة من المحارف تمثل اللاحقة المراد حذفها.

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

تعاد سلسلة من المحارف أو سلسلة نصية جديدة تحوي سلسلة المحارف أو السلسلة النصية المعطاة بعد إزالة اللاحقة prefix منها. إن لم تكن اللاحقة suffix موجودة في بداية سلسلة المحارف أو السلسلة النصية المعطاة، فستعاد نسخة عن سلسلة المحارف أو السلسلة النصية تلك.

أمثلة

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

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

انظر أيضًا

الدالة removePrefix()‎: تحذف بادئة معينة من سلسلة من المحارف أو سلسلة نصية.
الدالة removeSurrounding()‎: تحذف بادئة ولاحقة محددتين من سلسلة من المحارف أو سلسلة نصية.
الدالة endsWith()‎: تتحقق إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة.
الدالة commonSuffixWith()‎: تعيد أطول لاحقة (Suffix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها
الدالة padEnd()‎: تحشو نهاية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.removeSuffix()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>removeSuffix()‎</code> في Kotlin}}</noinclude>
-إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSuffix()‎</code> تبدأ بالبادئة <code>prefix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.
+تحذف الدالة <code>removeSuffix()‎</code> لاحقة معينة من [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]].
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.removePrefix(
+fun CharSequence.removeSuffix(
-     prefix: CharSequence
+     suffix: CharSequence
 ): CharSequence
-</syntaxhighlight>إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSuffix()‎</code> تبدأ بالبادئة <code>prefix</code> فستعيد الدالةُ [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.<syntaxhighlight lang="kotlin">
-fun String.removePrefix(prefix: CharSequence): String
-</syntaxhighlight>إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها الدالة <code>removeSuffix()‎</code> تبدأ بالبادئة <code>prefix</code> فستعيد [[Kotlin/String|سلسلة نصية]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]]  كما هي.
+fun String.removeSuffix(suffix: CharSequence): String
+</syntaxhighlight>
+==المعاملات==
+=== <code>suffix</code> ===
+[[Kotlin/CharSequence|سلسلة من المحارف]] تمثل اللاحقة المراد حذفها.
 ==القيم المعادة==
-[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]].
+تعاد [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]] جديدة تحوي [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة بعد إزالة اللاحقة <code>prefix</code> منها. إن لم تكن اللاحقة <code>suffix</code> موجودة في بداية [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة، فستعاد نسخة عن [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] تلك.
 ==أمثلة==
-===استخدام الدالة <code>()removeSuffix</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()removeSuffix</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()removeSuffix</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
 val str = "hsoub wiki"
-print( str.removePrefix ("hsoub ") ) // wiki
+print( str.removeSuffix ("wiki") ) // hsoub
-print( str.removePrefix ("xyz") ) // hsoub wiki
+print( str.removeSuffix ("xyz") ) // hsoub wiki
 }
 </syntaxhighlight>
-===انظر أيضًا===
+==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.
+* الدالة <code>[[Kotlin/kotlin.text/removePrefix|removePrefix()]]‎</code>: تحذف بادئة معينة من [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]].
+* الدالة <code>[[Kotlin/kotlin.text/removeSurrounding|removeSurrounding()‎]]</code>: تحذف بادئة ولاحقة محددتين من [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]].
-* <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
+* الدالة <code>[[Kotlin/kotlin.text/endsWith|endsWith()]]‎</code>: تتحقق إن كانت السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
+* الدالة <code>[[Kotlin/kotlin.text/commonSuffixWith|commonSuffixWith()]]‎</code>: تعيد أطول لاحقة (Suffix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها
+* الدالة <code>[[Kotlin/kotlin.text/padEnd|padEnd()]]‎</code>: تحشو نهاية سلسلة نصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/remove-prefix.html الدالة text.removeSuffix()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/remove-suffix.html الدالة removeSuffix()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]