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

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
لا ملخص تعديل
مراجعة وتدقيق.
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.removeSurrounding()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>removeSurrounding()‎</code> في Kotlin}}</noinclude>
إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSurrounding()‎</code> تنتهي باللاحقة <code>suffix</code>  وتبدأ بالبادئة <code>prefix</code>فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف اللاحقة  والبادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.  
تحذف الدالة <code>removeSurrounding()‎</code> بادئة ولاحقة محددتين من [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]]. 
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
سطر 7: سطر 7:
     suffix: CharSequence
     suffix: CharSequence
): CharSequence
): CharSequence
</syntaxhighlight>إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSurrounding()‎</code>  تبدأ بالبادئة <code>prefix</code> وتنتهي باللاحقة <code>suffix</code> فستعيد الدالةُ [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف اللاحقة والبادئة، وإلا فستعيد [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.<syntaxhighlight lang="kotlin">
 
fun String.removeSurrounding(
fun String.removeSurrounding(
     prefix: CharSequence,  
     prefix: CharSequence,  
     suffix: CharSequence
     suffix: CharSequence
): String
): String
</syntaxhighlight>إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها الدالة <code>removeSurrounding()‎</code>  تبدأ بالبادئة <code>prefix</code> وتنتهي باللاحقة <code>suffix</code> فستعيد [[Kotlin/String|سلسلة نصية]] جديدة مع حذف اللاحقة والبادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]]  كما هي.<syntaxhighlight lang="kotlin">
 
fun CharSequence.removeSurrounding(
fun CharSequence.removeSurrounding(
     delimiter: CharSequence
     delimiter: CharSequence
): CharSequence
): CharSequence
</syntaxhighlight>إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSurrounding()‎</code>  تبدأ وتنتهي [[Kotlin/CharSequence/index|بسلسلة الحروف]] المُمرّرة <code>delimiter</code> فستعيد الدالةُ [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف <code>delimiter</code> من البداية والنهاية، وإلا فستعيد [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.<syntaxhighlight lang="kotlin">
 
fun String.removeSurrounding(delimiter: CharSequence): String
fun String.removeSurrounding(delimiter: CharSequence): String


</syntaxhighlight>إن كانت<nowiki/>[[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها الدالة <code>removeSurrounding()‎</code>  تبدأ وتنتهي [[Kotlin/CharSequence/index|بسلسلة الحروف]] المُمرّرة <code>delimiter</code> فستعيد الدالةُ [[Kotlin/String|سلسلة نصية]] جديدة مع حذف <code>delimiter</code> من البداية والنهاية، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] كما هي.
</syntaxhighlight>
 
== المعاملات ==
 
=== <code>prefix</code> ===
[[Kotlin/CharSequence|سلسلة من المحارف]] تمثل البادئة المراد حذفها.
 
=== <code>suffix</code> ===
[[Kotlin/CharSequence|سلسلة من المحارف]] تمثل اللاحقة المراد حذفها.
 
=== <code>delimiter</code> ===
[[Kotlin/CharSequence|سلسلة من المحارف]] تمثل البادئة واللاحقة المراد حذفها. عند استعمال هذا المعامل، يجب أن تكون البادئة واللاحقة المراد حذفهما متماثلتين.


==القيم المعادة==
==القيم المعادة==
[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]].  
تعاد [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]] جديدة تحوي [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة بعد إزالة البادئة <code>prefix</code> واللاحقة <code>suffix</code>، أو البادئة واللاحقة <code>delimiter</code> منها. إن لم تكن البادئة <code>prefix</code>، أو اللاحقة <code>suffix</code>، أو البادئة واللاحقة <code>delimiter</code> موجودة في بداية أو نهاية أو بداية ونهاية [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة، فستعاد نسخة عن [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] تلك دون أي تعديل.  
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()removeSurrounding</code> مع سلسلة نصية===
مثالٌ على استعمال الدالة <code>()removeSurrounding</code><nowiki/>:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()removeSurrounding</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val str = "wiki.hsoub.com"  
    val str = "wiki.hsoub.com"
      
 
println( str.removeSurrounding ("wiki.", ".com") ) // hsoub  
     println(str.removeSurrounding("wiki.", ".com")) // hsoub
println( str.removeSurrounding ("xy", ".com") ) // wiki.hsoub.com
    println(str.removeSurrounding("xy", ".com"))   // wiki.hsoub.com
    println(str.removeSurrounding("wiki"))          // wiki.hsoub.com
}
}
</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/removeSuffix|removeSuffix()]]‎</code>: إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالة <code>removeSuffix()‎</code> تنتهي باللاحقة <code>suffix</code>فستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك اللاحقة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي. 
* الدالة <code>[[Kotlin/kotlin.text/removeSuffix|removeSuffix()]]‎</code>: تحذف لاحقة معينة من [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]]. 


* <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
* الدالة <code>[[Kotlin/kotlin.text/removeRange|removeRange()‎]]</code>: تحذف مجالًا محددًا من [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها. 
* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.


==مصادر==
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/remove-surrounding.html الدالة text.removeSurrounding()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/remove-surrounding.html صفحة الدالة removeSurrounding()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]

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

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

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

fun CharSequence.removeSurrounding(
    prefix: CharSequence, 
    suffix: CharSequence
): CharSequence

fun String.removeSurrounding(
    prefix: CharSequence, 
    suffix: CharSequence
): String

fun CharSequence.removeSurrounding(
    delimiter: CharSequence
): CharSequence

fun String.removeSurrounding(delimiter: CharSequence): String

المعاملات

prefix

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

suffix

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

delimiter

سلسلة من المحارف تمثل البادئة واللاحقة المراد حذفها. عند استعمال هذا المعامل، يجب أن تكون البادئة واللاحقة المراد حذفهما متماثلتين.

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

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

أمثلة

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

fun main(args: Array<String>) {
    val str = "wiki.hsoub.com"

    println(str.removeSurrounding("wiki.", ".com")) // hsoub
    println(str.removeSurrounding("xy", ".com"))    // wiki.hsoub.com
    println(str.removeSurrounding("wiki"))          // wiki.hsoub.com
}

انظر أيضًا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/removeSurrounding&oldid=16554»