الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/substringBefore»
< Kotlin | kotlin.text
ط استبدال النص - 'Kotlin Functions' ب'Kotlin Function' |
جميل-بيلوني (نقاش | مساهمات) مراجعة وتدقيق. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code> | <noinclude>{{DISPLAYTITLE: الدالة <code>substringBefore()</code> في Kotlin}}</noinclude> | ||
تجلب الدالة <code>substringBefore()</code> كل الجزء الواقع قبل أول ظهور <nowiki/>[[Kotlin/Char|لمحرف]] أو لسلسلة نصية معينة في سلسلة نصية. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 12: | سطر 12: | ||
): String | ): String | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | |||
=== <code>delimiter</code> === | |||
المحرف أو السلسلة النصية التي يراد جلب كامل الجزء الواقع قبلها. | |||
=== <code>missingDelimiterValue</code> === | |||
السلسلة النصية التي ستعاد في حال لم يكن المعامل <code>delimiter</code> موجودًا ضمن السلسلة النصية المعطاة. القيمة الافتراضية هي: <code>this</code> (أي السلسلة النصية المعطاة نفسها). | |||
== القيم المعادة == | == القيم المعادة == | ||
تعاد سلسلة نصية تحوي كل الجزء الواقع قبل أول ظهور للمعامل <code>delimiter</code> في السلسلة النصية المعطاة. | |||
== أمثلة == | |||
مثالٌ على استعمال الدالة <code>()substringBefore</code>:<nowiki/><syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val str = "wiki.hsoub.com" | val str = "wiki.hsoub.com" | ||
| سطر 32: | سطر 40: | ||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/substring-before.html الدالة | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/substring-before.html صفحة الدالة String.substringBefore() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Function]] | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Text]] | |||
مراجعة 14:35، 5 سبتمبر 2018
تجلب الدالة substringBefore() كل الجزء الواقع قبل أول ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية.
البنية العامة
fun String.substringBefore(
delimiter: Char,
missingDelimiterValue: String = this
): String
fun String.substringBefore(
delimiter: String,
missingDelimiterValue: String = this
): String
المعاملات
delimiter
المحرف أو السلسلة النصية التي يراد جلب كامل الجزء الواقع قبلها.
missingDelimiterValue
السلسلة النصية التي ستعاد في حال لم يكن المعامل delimiter موجودًا ضمن السلسلة النصية المعطاة. القيمة الافتراضية هي: this (أي السلسلة النصية المعطاة نفسها).
القيم المعادة
تعاد سلسلة نصية تحوي كل الجزء الواقع قبل أول ظهور للمعامل delimiter في السلسلة النصية المعطاة.
أمثلة
مثالٌ على استعمال الدالة ()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()سلسلة حروف أو سلسلة نصية جديدة تحتوي الحروف التي تنتمي فهارسها إلى الوسيط المُمرر.