الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/startsWith»
< Kotlin | kotlin.text
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.startsWith()</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>startsWith()</code> القيم...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>text.startsWith()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>text.startsWith()</code> في لغة Kotlin}}</noinclude> | ||
تعيد الدالة <code>startsWith()</code> القيمة <code>true</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها | تعيد الدالة <code>startsWith()</code> القيمة <code>true</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها تبدأ بالحرف أو السابقة المُمرّرة. الوسيط <code>ignoreCase</code> يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
fun String. | fun String.startsWith( | ||
prefix: String, | |||
ignoreCase: Boolean = false | ignoreCase: Boolean = false | ||
): Boolean | ): Boolean | ||
fun CharSequence. | fun CharSequence.startsWith( | ||
prefix: CharSequence, | |||
ignoreCase: Boolean = false | |||
): Boolean | |||
</syntaxhighlight>تعيد الدالة <code>startsWith()</code> القيمة <code>true</code> إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها تبدأ بالبادئة <code>prefix.</code><syntaxhighlight lang="kotlin"> | |||
fun String.startsWith( | |||
prefix: String, | |||
startIndex: Int, | |||
ignoreCase: Boolean = false | ignoreCase: Boolean = false | ||
): Boolean | ): Boolean | ||
fun CharSequence. | fun CharSequence.startsWith( | ||
prefix: CharSequence, | |||
startIndex: Int, | |||
ignoreCase: Boolean = false | ignoreCase: Boolean = false | ||
): Boolean | ): Boolean | ||
</syntaxhighlight> | </syntaxhighlight>تعيد الدالة <code>startsWith()</code> القيمة <code>true</code> إن كانت الجزء من [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والذي يبدأ عند الفهرس المحدد <code>startIndex</code> يبدأ بالبادئة <code>prefix.</code> | ||
==القيم المعادة== | ==القيم المعادة== | ||
قيمة منطقية. | قيمة منطقية. | ||
| سطر 24: | سطر 32: | ||
تعرِّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة <code>()startsWith</code> عبرها مع تمرير [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin"> | تعرِّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة <code>()startsWith</code> عبرها مع تمرير [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val str = "wiki | val str = "wiki.hsoub.com" | ||
println(str. | println(str.startsWith("wiki")) // true | ||
println(str. | println(str.startsWith("xyz")) // false | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* <code>[[Kotlin/kotlin.text/endsWith|endsWith()]]</code>: تعيد الدالة <code>endsWith()</code> القيمة <code>true</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] أو [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها تنتهي بالحرف أو اللاحقة المُمرّرة. الوسيط <code>ignoreCase</code> يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف. | |||
* <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]</code>: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>. | * <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]</code>: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>. | ||
| سطر 36: | سطر 45: | ||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/ | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/starts-with.html الدالة text.startsWith() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 12:22، 12 يوليو 2018
تعيد الدالة startsWith() القيمة true إن كانت سلسلة الحروف أو السلسلة النصية التي استُدعيت عبرها تبدأ بالحرف أو السابقة المُمرّرة. الوسيط ignoreCase يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.
البنية العامة
fun String.startsWith(
prefix: String,
ignoreCase: Boolean = false
): Boolean
fun CharSequence.startsWith(
prefix: CharSequence,
ignoreCase: Boolean = false
): Boolean
تعيد الدالة startsWith() القيمة true إن كانت السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها تبدأ بالبادئة prefix.
fun String.startsWith(
prefix: String,
startIndex: Int,
ignoreCase: Boolean = false
): Boolean
fun CharSequence.startsWith(
prefix: CharSequence,
startIndex: Int,
ignoreCase: Boolean = false
): Boolean
تعيد الدالة startsWith() القيمة true إن كانت الجزء من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها والذي يبدأ عند الفهرس المحدد startIndex يبدأ بالبادئة prefix.
القيم المعادة
قيمة منطقية.
أمثلة
استخدام الدالة ()startsWith مع سلسلة نصية
تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()startsWith عبرها مع تمرير سلسلة نصية كوسيط، ثمَّ تطبع الناتج:
fun main(args: Array<String>) {
val str = "wiki.hsoub.com"
println(str.startsWith("wiki")) // true
println(str.startsWith("xyz")) // false
}
انظر أيضًا
endsWith(): تعيد الدالةendsWith()القيمةtrueإن كانت سلسلة الحروف أو السلسلة النصية التي استُدعيت عبرها تنتهي بالحرف أو اللاحقة المُمرّرة. الوسيطignoreCaseيحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.elementAt(): تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناءIndexOutOfBoundsException.
compareTo(): تقارن بين سلسلتين نصيتين.