الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/replaceBefore»
< Kotlin | kotlin.text
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.replaceBefore()</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>replaceBefore()</code> Kot...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>text.replaceBefore()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>text.replaceBefore()</code> في لغة Kotlin}}</noinclude> | ||
تعيد الدالة <code>replaceBefore()</code> [[Kotlin/String|سلسلة نصية]] جديدة تساوي [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها مع تعويض الجزء الذي يظهر | تعيد الدالة <code>replaceBefore()</code> [[Kotlin/String|سلسلة نصية]] جديدة تساوي [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها مع تعويض الجزء الذي يظهر قبل الوسيط المُمرّر <code>delimiter</code> [[Kotlin/String|بالسلسلة النصية]] <code>replacement</code>. إن لم لم تحتو [[Kotlin/String|السلسلة النصية]] على <code>delimiter</code> فستعيد <code>missingDelimiterValue</code> والذي يساوي افتراضيا [[Kotlin/String|السلسلة النصية]] الأصلية. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
fun String. | fun String.replaceBefore( | ||
delimiter: Char, | delimiter: Char, | ||
replacement: String, | replacement: String, | ||
missingDelimiterValue: String = this | missingDelimiterValue: String = this | ||
): String | ): String | ||
fun String. | fun String.replaceBefore( | ||
delimiter: String, | delimiter: String, | ||
replacement: String, | replacement: String, | ||
| سطر 18: | سطر 18: | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()replaceBefore</code> مع سلسلة نصية=== | ===استخدام الدالة <code>()replaceBefore</code> مع سلسلة نصية=== | ||
تعرِّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة <code>()replaceBefore</code> عبرها مع حرف و<nowiki/>[[Kotlin/String|سلسلة نصية]] كوسيطين، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin"> | تعرِّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة <code>()replaceBefore</code> عبرها مع تمرير حرف و<nowiki/>[[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. | println( str.replaceBefore ('.',"Hsoub") ) // Hsoub.hsoub.com | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 28: | سطر 28: | ||
* <code>[[Kotlin/kotlin.text/replace|replace()]]</code>:تعيد [[Kotlin/String|سلسلة نصية]] جديدة مع استبدال جزء من السلسلة النصية الأصلية. | * <code>[[Kotlin/kotlin.text/replace|replace()]]</code>:تعيد [[Kotlin/String|سلسلة نصية]] جديدة مع استبدال جزء من السلسلة النصية الأصلية. | ||
* <code>[[Kotlin/kotlin.text/ | * <code>[[Kotlin/kotlin.text/replaceAfter|replaceAfter()]]</code>: تعيد الدالة <code>replaceAfter()</code> [[Kotlin/String|سلسلة نصية]] جديدة تساوي [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها مع تعويض الجزء الذي يظهر بعد الوسيط المُمرّر <code>delimiter</code> [[Kotlin/String|بالسلسلة النصية]] <code>replacement</code>. إن لم لم تحتو [[Kotlin/String|السلسلة النصية]] على <code>delimiter</code> فستعيد <code>missingDelimiterValue</code> والذي يساوي افتراضيا [[Kotlin/String|السلسلة النصية]] الأصلية. | ||
* <code>[[Kotlin/kotlin.text/removeSuffix|removeSuffix()]]</code>: إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSuffix()</code> تنتهي باللاحقة <code>suffix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك اللاحقة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي. | * <code>[[Kotlin/kotlin.text/removeSuffix|removeSuffix()]]</code>: إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSuffix()</code> تنتهي باللاحقة <code>suffix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك اللاحقة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي. | ||
| سطر 34: | سطر 34: | ||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/replace- | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/replace-before.html الدالة text.replaceBefore() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 08:14، 12 يوليو 2018
تعيد الدالة replaceBefore() سلسلة نصية جديدة تساوي السلسلة النصية التي استُدعيت عبرها مع تعويض الجزء الذي يظهر قبل الوسيط المُمرّر delimiter بالسلسلة النصية replacement. إن لم لم تحتو السلسلة النصية على delimiter فستعيد missingDelimiterValue والذي يساوي افتراضيا السلسلة النصية الأصلية.
البنية العامة
fun String.replaceBefore(
delimiter: Char,
replacement: String,
missingDelimiterValue: String = this
): String
fun String.replaceBefore(
delimiter: String,
replacement: String,
missingDelimiterValue: String = this
): String
القيم المعادة
أمثلة
استخدام الدالة ()replaceBefore مع سلسلة نصية
تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()replaceBefore عبرها مع تمرير حرف وسلسلة نصية كوسيطين، ثمَّ تطبع الناتج:
fun main(args: Array<String>) {
val str = "wiki.hsoub.com"
println( str.replaceBefore ('.',"Hsoub") ) // Hsoub.hsoub.com
}
انظر أيضًا
replace():تعيد سلسلة نصية جديدة مع استبدال جزء من السلسلة النصية الأصلية.
replaceAfter(): تعيد الدالةreplaceAfter()سلسلة نصية جديدة تساوي السلسلة النصية التي استُدعيت عبرها مع تعويض الجزء الذي يظهر بعد الوسيط المُمرّرdelimiterبالسلسلة النصيةreplacement. إن لم لم تحتو السلسلة النصية علىdelimiterفستعيدmissingDelimiterValueوالذي يساوي افتراضيا السلسلة النصية الأصلية.
removeSuffix(): إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالةremoveSuffix()تنتهي باللاحقةsuffixفستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك اللاحقة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.asSequence(): تنشئ كائنًا من الصنفSequenceوالذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.