الفرق بين المراجعتين ل"Kotlin/kotlin.text/substringBefore"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.substringBefore()</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>substringBefore()</code>...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>text.substringBefore()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>text.substringBefore()</code> في لغة Kotlin}}</noinclude> | ||
| − | تعيد الدالة <code>substringBefore()</code> جزءًا من [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها والمُتواجد | + | تعيد الدالة <code>substringBefore()</code> جزءًا من [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها والمُتواجد قبل أول ظهور للمُحدِّد <code>delimiter،</code> إن لم تكن [[Kotlin/String|السلسلة النصية]] الأصلية تحتوي <code>delimiter</code>، فستعيد القيمة المُمرّرة <code>missingDelimiterValue</code>، والتي قيمتها الافتراضية هي [[Kotlin/String|السلسلة النصية]] الأصلية. |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| − | fun String. | + | fun String.substringBefore( |
delimiter: Char, | delimiter: Char, | ||
missingDelimiterValue: String = this | missingDelimiterValue: String = this | ||
| − | ): String | + | ): String |
| − | fun String. | + | fun String.substringBefore( |
delimiter: String, | delimiter: String, | ||
missingDelimiterValue: String = this | missingDelimiterValue: String = this | ||
| − | ): String | + | ): String |
| − | </syntaxhighlight> | + | </syntaxhighlight> |
| − | |||
| − | ==القيم المعادة== | + | == القيم المعادة == |
[[Kotlin/String|سلسلة نصية]]. | [[Kotlin/String|سلسلة نصية]]. | ||
==أمثلة== | ==أمثلة== | ||
| سطر 22: | سطر 21: | ||
val str = "wiki.hsoub.com" | val str = "wiki.hsoub.com" | ||
| − | println(str. | + | println(str.substringBefore('.')) // wiki |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* <code>[[Kotlin/kotlin.text/substring|substring()]]</code>: تعيد الدالة <code>substring()</code> جزءًا من [[Kotlin/CharSequence/index|سلسلة الحروف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها والمُحدد بالوسائط المُمررة (انظر فقرة [[Kotlin/kotlin.text/substring#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]). | * <code>[[Kotlin/kotlin.text/substring|substring()]]</code>: تعيد الدالة <code>substring()</code> جزءًا من [[Kotlin/CharSequence/index|سلسلة الحروف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها والمُحدد بالوسائط المُمررة (انظر فقرة [[Kotlin/kotlin.text/substring#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]). | ||
| + | * <code>[[Kotlin/kotlin.text/substringAfter|substringAfter()]]</code>: تعيد الدالة <code>substringAfter()</code> جزءًا من [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها والمُتواجد بعد أول ظهور للمُحدِّد <code>delimiter،</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|سلسلة الحروف]] كما هي. | ||
| سطر 32: | سطر 32: | ||
==مصادر== | ==مصادر== | ||
| − | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/substring- | + | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/substring-before.html الدالة text.substringBefore() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 17:27، 12 يوليو 2018
تعيد الدالة substringBefore() جزءًا من السلسلة النصية التي استُدعيت عبرها والمُتواجد قبل أول ظهور للمُحدِّد delimiter، إن لم تكن السلسلة النصية الأصلية تحتوي delimiter، فستعيد القيمة المُمرّرة missingDelimiterValue، والتي قيمتها الافتراضية هي السلسلة النصية الأصلية.
البنية العامة
fun String.substringBefore(
delimiter: Char,
missingDelimiterValue: String = this
): String
fun String.substringBefore(
delimiter: String,
missingDelimiterValue: String = this
): String
القيم المعادة
أمثلة
استخدام الدالة ()substringBefore مع سلسلة نصية
تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()substringBefore عبرها مع تمرير حرف كوسيط، ثمَّ تطبع الناتج:
fun main(args: Array<String>) {
val str = "wiki.hsoub.com"
println(str.substringBefore('.')) // wiki
}
انظر أيضًا
substring(): تعيد الدالةsubstring()جزءًا من سلسلة الحروف أو السلسلة النصية التي استُدعيت عبرها والمُحدد بالوسائط المُمررة (انظر فقرة البنية العامة).substringAfter(): تعيد الدالةsubstringAfter()جزءًا من السلسلة النصية التي استُدعيت عبرها والمُتواجد بعد أول ظهور للمُحدِّدdelimiter،إن لم تكن السلسلة النصية الأصلية تحتويdelimiter، فستعيد القيمة المُمرّرةmissingDelimiterValue، والتي قيمتها الافتراضية هي السلسلة النصية الأصلية.
removeSuffix(): إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالةremoveSuffix()تنتهي باللاحقةsuffixفستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك اللاحقة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.slice(): تعيد الدالةslice()سلسلة حروف أو سلسلة نصية جديدة تحتوي الحروف التي تنتمي فهارسها إلى الوسيط المُمرر.