عرض مصدر Kotlin/kotlin.text/removeSurrounding

<noinclude>{{DISPLAYTITLE: الدالة <code>removeSurrounding()‎</code> في Kotlin}}</noinclude>
تحذف الدالة <code>removeSurrounding()‎</code> بادئة ولاحقة محددتين من [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]].  
==البنية العامة==
<syntaxhighlight lang="kotlin">
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

</syntaxhighlight>

== المعاملات ==

=== <code>prefix</code> ===
[[Kotlin/CharSequence|سلسلة من المحارف]] تمثل البادئة المراد حذفها.

=== <code>suffix</code> ===
[[Kotlin/CharSequence|سلسلة من المحارف]] تمثل اللاحقة المراد حذفها.

=== <code>delimiter</code> ===
[[Kotlin/CharSequence|سلسلة من المحارف]] تمثل البادئة واللاحقة المراد حذفها. عند استعمال هذا المعامل، يجب أن تكون البادئة واللاحقة المراد حذفهما متماثلتين.

==القيم المعادة==
تعاد [[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><nowiki/>:<syntaxhighlight lang="kotlin">
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
}
</syntaxhighlight>
==انظر أيضًا==
* الدالة <code>[[Kotlin/kotlin.text/removePrefix|removePrefix()]]‎</code>: تحذف بادئة معينة من [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]].

* الدالة <code>[[Kotlin/kotlin.text/removeSuffix|removeSuffix()]]‎</code>: تحذف لاحقة معينة من [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]]. 

* الدالة <code>[[Kotlin/kotlin.text/removeRange|removeRange()‎]]</code>: تحذف مجالًا محددًا من [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها. 

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