الدالة text.removeSurrounding() في لغة Kotlin
إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالة removeSurrounding() تنتهي باللاحقة suffix وتبدأ بالبادئة prefixفستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف اللاحقة والبادئة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.
البنية العامة
fun CharSequence.removeSurrounding(
prefix: CharSequence,
suffix: CharSequence
): CharSequence
إن كانت سلسلة الحروف التي استٌدعيت عبرها الدالة removeSurrounding() تبدأ بالبادئة prefix وتنتهي باللاحقة suffix فستعيد الدالةُ سلسلة حروف جديدة مع حذف اللاحقة والبادئة، وإلا فستعيد سلسلة الحروف كما هي.
fun String.removeSurrounding(
prefix: CharSequence,
suffix: CharSequence
): String
إن كانت السلسلة النصية التي استٌدعيت عبرها الدالة removeSurrounding() تبدأ بالبادئة prefix وتنتهي باللاحقة suffix فستعيد سلسلة نصية جديدة مع حذف اللاحقة والبادئة، وإلا فستعيد السلسلة النصية كما هي.
fun CharSequence.removeSurrounding(
delimiter: CharSequence
): CharSequence
إن كانت سلسلة الحروف التي استٌدعيت عبرها الدالة removeSurrounding() تبدأ وتنتهي بسلسلة الحروف المُمرّرة delimiter فستعيد الدالةُ سلسلة حروف جديدة مع حذف delimiter من البداية والنهاية، وإلا فستعيد سلسلة الحروف كما هي.
fun String.removeSurrounding(delimiter: CharSequence): String
إن كانتالسلسلة النصية التي استٌدعيت عبرها الدالة removeSurrounding() تبدأ وتنتهي بسلسلة الحروف المُمرّرة delimiter فستعيد الدالةُ سلسلة نصية جديدة مع حذف delimiter من البداية والنهاية، وإلا فستعيد السلسلة النصية كما هي.
القيم المعادة
أمثلة
استخدام الدالة ()removeSurrounding مع سلسلة نصية
تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()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
}
انظر أيضًا
removePrefix(): إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالةremovePrefix()تبدأ بالبادئةprefixفستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك البادئة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.
removeSuffix(): إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالةremoveSuffix()تنتهي باللاحقةsuffixفستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك اللاحقة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.
compareTo(): تقارن بين سلسلتين نصيتين.asSequence(): تنشئ كائنًا من الصنفSequenceوالذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.