الفرق بين المراجعتين ل"Kotlin/kotlin.text/removeSuffix"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 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>suffix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك اللاحقة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.  
+
تحذف الدالة <code>removeSuffix()‎</code> لاحقة معينة من [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]].  
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
fun CharSequence.removePrefix(
+
fun CharSequence.removeSuffix(
     prefix: CharSequence
+
     suffix: CharSequence
 
): CharSequence
 
): CharSequence
</syntaxhighlight>إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSuffix()‎</code> تنتهي باللاحقة <code>suffix</code> فستعيد الدالةُ [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك اللاحقة، وإلا فستعيد [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.<syntaxhighlight lang="kotlin">
 
fun String.removePrefix(prefix: CharSequence): String
 
  
</syntaxhighlight>إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها الدالة <code>removeSuffix()</code>تنتهي باللاحقة <code>suffix</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>) {
 
fun main(args: Array<String>) {
 
val str = "hsoub wiki"  
 
val str = "hsoub wiki"  
سطر 24: سطر 26:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
* <code>[[Kotlin/kotlin.text/removePrefix|removePrefix()]]‎</code>: إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removePrefix()‎</code> تبدأ بالبادئة <code>prefix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي. 
+
* الدالة <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-suffix.html الدالة text.removeSuffix()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/remove-suffix.html الدالة removeSuffix()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]

المراجعة الحالية بتاريخ 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
}

انظر أيضًا

مصادر