الفرق بين المراجعتين ل"Kotlin/kotlin.text/indexOf"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - 'Kotlin Methods' ب'Kotlin Function') |
جميل-بيلوني (نقاش | مساهمات) ط |
||
| (مراجعتان متوسطتان بواسطة نفس المستخدم غير معروضتين) | |||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: الدالة | + | <noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.indexOf()</code> في Kotlin}}</noinclude> |
| − | + | تجلب الدالة <code>indexOf()</code> فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. | |
| − | |||
| − | |||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 17: | سطر 15: | ||
): Int | ): Int | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| + | |||
| + | == المعاملات == | ||
| + | |||
| + | === <code>char</code> === | ||
| + | المحرف المراد البحث عنه ضمن [[Kotlin/CharSequence|سلسلة من المحارف]]. | ||
| + | |||
| + | === <code>startIndex</code> === | ||
| + | السلسلة النصية المراد البحث عنها ضمن [[Kotlin/CharSequence|سلسلة من المحارف]]. | ||
| + | |||
| + | === <code>ignoreCase</code> === | ||
| + | قيمة منطقية تحدد إن كان يراد إهمال حالة المحارف أثناء عملية البحث أم لا. القيمة الافتراضية هي: <code>false</code> (أي أخذ حالة المحارف بالحسبان). | ||
| + | |||
== القيم المعادة == | == القيم المعادة == | ||
| − | فهرس أول ظهور | + | يعاد عدد صحيح يمثل فهرس أول ظهور للمحرف <code>char</code> أو السلسلة النصية <code>string</code> في <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المعطاة، أو القيمة -1 إن لم يُعثَر على شيء. |
== أمثلة == | == أمثلة == | ||
| − | + | <nowiki/><nowiki/>مثالٌ على استعمال الدالة <code>()indexOf</code> للبحث عن محارف:<syntaxhighlight lang="kotlin"> | |
| − | |||
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | var str = "hsoub" | + | var str = "hsoub" |
| − | |||
| − | |||
| − | |||
| + | print(str.indexOf('s')) // 1 | ||
| + | print(str.indexOf('x')) // -1 | ||
} | } | ||
| − | </syntaxhighlight> | + | </syntaxhighlight><nowiki/>مثالٌ آخر على استعمال الدالة <code>()indexOf</code> للبحث عن سلسلة نصية:<syntaxhighlight lang="kotlin"> |
| + | fun main(args: Array<String>) { | ||
| + | var str = "hsoub" | ||
| − | + | print(str.indexOf("sou", 2, true)) // -1 | |
| − | + | print(str.indexOf("sx", 1)) // -1 | |
| − | |||
| − | |||
| − | |||
| − | print(str.indexOf("sou")) // 1 | ||
| − | print(str.indexOf("sx")) // -1 | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * <code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny | + | * الدالة <code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny()]]</code>: تجلب فهرس أول ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها. |
| + | * الدالة <code>[[Kotlin/kotlin.text/indexOfFirst|indexOfFirst()]]</code>: تجلب فهرس أول محرف يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. | ||
| + | * الدالة <code>[[Kotlin/kotlin.text/lastIndexOf|lastIndexOf()]]</code>: تجلب فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. | ||
| + | * الدالة <code>[[Kotlin/kotlin.text/find|find()]]</code>: تبحث على محرف يحقق شرطًا محدَّدًا ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له. | ||
| + | * الدالة <code>[[Kotlin/kotlin.text/filter|filter()]]</code>: ترشِّح محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا. | ||
== مصادر == | == مصادر == | ||
| − | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index-of.html الدالة | + | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index-of.html صفحة الدالة CharSequence.indexOf() في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Function]] | [[تصنيف:Kotlin Function]] | ||
| + | [[تصنيف:Kotlin Text]] | ||
| + | [[تصنيف:Kotlin CharSequence]] | ||
المراجعة الحالية بتاريخ 07:31، 4 سبتمبر 2018
تجلب الدالة indexOf() فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها.
البنية العامة
fun CharSequence.indexOf(
char: Char,
startIndex: Int = 0,
ignoreCase: Boolean = false
): Int
fun CharSequence.indexOf(
string: String,
startIndex: Int = 0,
ignoreCase: Boolean = false
): Int
المعاملات
char
المحرف المراد البحث عنه ضمن سلسلة من المحارف.
startIndex
السلسلة النصية المراد البحث عنها ضمن سلسلة من المحارف.
ignoreCase
قيمة منطقية تحدد إن كان يراد إهمال حالة المحارف أثناء عملية البحث أم لا. القيمة الافتراضية هي: false (أي أخذ حالة المحارف بالحسبان).
القيم المعادة
يعاد عدد صحيح يمثل فهرس أول ظهور للمحرف char أو السلسلة النصية string في سلسلة المحارف المعطاة، أو القيمة -1 إن لم يُعثَر على شيء.
أمثلة
مثالٌ على استعمال الدالة ()indexOf للبحث عن محارف:
fun main(args: Array<String>) {
var str = "hsoub"
print(str.indexOf('s')) // 1
print(str.indexOf('x')) // -1
}
مثالٌ آخر على استعمال الدالة ()indexOf للبحث عن سلسلة نصية:
fun main(args: Array<String>) {
var str = "hsoub"
print(str.indexOf("sou", 2, true)) // -1
print(str.indexOf("sx", 1)) // -1
}
انظر أيضًا
- الدالة
indexOfAny(): تجلب فهرس أول ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من سلسلة المحارف التي استُدعيت معها. - الدالة
indexOfFirst(): تجلب فهرس أول محرف يحقِّق شرطًا معيَّنًا من سلسلة المحارف التي استُدعيت معها. - الدالة
lastIndexOf(): تجلب فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها. - الدالة
find(): تبحث على محرف يحقق شرطًا محدَّدًا ضمن محارف السلسلة التي استُدعيت معها ثمَّ تعيد أول ظهور له. - الدالة
filter(): ترشِّح محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.