الفرق بين المراجعتين ل"Kotlin/kotlin.text/removeSurrounding"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.removeSurrounding()</code> في لغة Kotlin}}</noinclude> إن كانت Kotlin/String|السلسلة النصي...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>text.removeSurrounding()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>text.removeSurrounding()</code> في لغة Kotlin}}</noinclude> | ||
| − | إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSurrounding()</code> تنتهي باللاحقة <code>suffix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف | + | إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSurrounding()</code> تنتهي باللاحقة <code>suffix</code> وتبدأ بالبادئة <code>prefix</code>فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف اللاحقة والبادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي. |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| − | fun CharSequence. | + | fun CharSequence.removeSurrounding( |
| − | prefix: CharSequence | + | prefix: CharSequence, |
| + | suffix: CharSequence | ||
): CharSequence | ): CharSequence | ||
| − | </syntaxhighlight>إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSurrounding()</code> | + | </syntaxhighlight>إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSurrounding()</code> تبدأ بالبادئة <code>prefix</code> وتنتهي باللاحقة <code>suffix</code> فستعيد الدالةُ [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف اللاحقة والبادئة، وإلا فستعيد [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.<syntaxhighlight lang="kotlin"> |
| − | fun String. | + | fun String.removeSurrounding( |
| + | prefix: CharSequence, | ||
| + | suffix: CharSequence | ||
| + | ): String | ||
| + | </syntaxhighlight>إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها الدالة <code>removeSurrounding()</code> تبدأ بالبادئة <code>prefix</code> وتنتهي باللاحقة <code>suffix</code> فستعيد [[Kotlin/String|سلسلة نصية]] جديدة مع حذف اللاحقة والبادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] كما هي.<syntaxhighlight lang="kotlin"> | ||
| + | fun CharSequence.removeSurrounding( | ||
| + | delimiter: 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 | ||
| − | </syntaxhighlight>إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها الدالة <code>removeSurrounding()</code> | + | </syntaxhighlight>إن كانت<nowiki/>[[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها الدالة <code>removeSurrounding()</code> تبدأ وتنتهي [[Kotlin/CharSequence/index|بسلسلة الحروف]] المُمرّرة <code>delimiter</code> فستعيد الدالةُ [[Kotlin/String|سلسلة نصية]] جديدة مع حذف <code>delimiter</code> من البداية والنهاية، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] كما هي. |
==القيم المعادة== | ==القيم المعادة== | ||
| سطر 17: | سطر 27: | ||
تعرِّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة <code>()removeSurrounding</code> عبرها مع تمرير [[Kotlin/String|سلسلة نصية]] كوسيط، <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 = "hsoub | + | val str = "wiki.hsoub.com" |
| − | + | println( str.removeSurrounding ("wiki.", ".com") ) // hsoub | |
| − | + | println( str.removeSurrounding ("xy", ".com") ) // 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/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removePrefix()</code> تبدأ بالبادئة <code>prefix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي. | ||
| + | |||
| + | * <code>[[Kotlin/kotlin.text/removeSuffix|removeSuffix()]]</code>: إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالة <code>removeSuffix()</code> تنتهي باللاحقة <code>suffix</code>فستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك اللاحقة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي. | ||
* <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]</code>: تقارن بين سلسلتين نصيتين. | * <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]</code>: تقارن بين سلسلتين نصيتين. | ||
| سطر 30: | سطر 42: | ||
==مصادر== | ==مصادر== | ||
| − | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/remove- | + | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/remove-surrounding.html الدالة text.removeSurrounding() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 21:27، 11 يوليو 2018
إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالة 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والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.