الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/indexOfFirst»
< Kotlin | kotlin.text
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة text.indexOfFirst() في لغة Kotlin}}</noinclude> تعيد الدالة <code>indexOfFirst()</code> فهرس أول ظه...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة text.indexOfFirst() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة text.indexOfFirst() في لغة Kotlin}}</noinclude> | ||
تعيد الدالة <code>indexOfFirst()</code> فهرس أول ظهور للحرف | تعيد الدالة <code>indexOfFirst()</code> فهرس أول ظهور للحرف المُمرّر إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code>، وفي حال كان ذلك الحرف غير موجود فستعيد العدد <code>-1</code>. | ||
== البنية العامة == | == البنية العامة == | ||
يمكن استدعاء الدالة <code>indexOf()</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin"> | يمكن استدعاء الدالة <code>indexOf()</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin"> | ||
fun CharSequence. | inline fun CharSequence.indexOfFirst( | ||
predicate: (Char) -> Boolean | |||
): Int | ): Int | ||
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | |||
== القيم المعادة == | == القيم المعادة == | ||
عدد من النوع <code>Int</code>. | |||
== أمثلة == | == أمثلة == | ||
=== استخدام الدالة<code>()indexOfFirst</code>مع سلسلة نصية | === استخدام الدالة<code>()indexOfFirst</code>مع سلسلة نصية === | ||
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code><nowiki/>، ثم تستخدم الدالة <code>()indexOfFirst</code> | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code><nowiki/>، ثم تستخدم الدالة <code>()indexOfFirst</code> للحصول على فهرس أول حرف يحقق الدالة المُمررة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
var str = "hsoub" | var str = "hsoub" | ||
print(str. | print(str.indexOfFirst { it > 'm' }) // 1 | ||
print(str. | print(str.indexOfFirst { it > 'x' }) // -1 | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
=== | === <nowiki/>انظر أيضًا === | ||
* <code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny]]()</code>: تعيد فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف أو تلك [[Kotlin/String|السلسلة النصية]] المُمرّرة غير موجودة فستعيد الدالةُ العدد <code>-1</code>. | * <code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny]]()</code>: تعيد فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف أو تلك [[Kotlin/String|السلسلة النصية]] المُمرّرة غير موجودة فستعيد الدالةُ العدد <code>-1</code>. | ||
* <code>[[Kotlin/kotlin.text/indexOf|indexOf]]()</code>: تعيد الدالة <code>indexOf()</code> فهرس أول ظهور للحرف أو السلسلة النصية المُمرّرة إليها في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف غير موجود فستعيد العدد <code>-1</code>. | |||
== مصادر == | == مصادر == | ||
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index-of.html الدالة text.indexOfFirst() في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.] | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index-of-first.html الدالة text.indexOfFirst() في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Methods]] | [[تصنيف:Kotlin Methods]] | ||
مراجعة 21:35، 9 يوليو 2018
تعيد الدالة indexOfFirst() فهرس أول ظهور للحرف المُمرّر إليها في سلسلة الحروف التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate، وفي حال كان ذلك الحرف غير موجود فستعيد العدد -1.
البنية العامة
يمكن استدعاء الدالة indexOf() عبر المصفوفات:
inline fun CharSequence.indexOfFirst(
predicate: (Char) -> Boolean
): Int
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
عدد من النوع Int.
أمثلة
استخدام الدالة()indexOfFirstمع سلسلة نصية
تعرف الشيفرة الآتية سلسلة نصية باسم str، ثم تستخدم الدالة ()indexOfFirst للحصول على فهرس أول حرف يحقق الدالة المُمررة، ثم تطبع الناتج:
fun main(args: Array<String>) {
var str = "hsoub"
print(str.indexOfFirst { it > 'm' }) // 1
print(str.indexOfFirst { it > 'x' }) // -1
}
انظر أيضًا
indexOfAny(): تعيد فهرس أول ظهور للحرف أو السلسلة النصية المُمرّرة إليها في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس المُمرّرstartIndex، في حال كان ذلك الحرف أو تلك السلسلة النصية المُمرّرة غير موجودة فستعيد الدالةُ العدد -1.
indexOf(): تعيد الدالةindexOf()فهرس أول ظهور للحرف أو السلسلة النصية المُمرّرة إليها في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس المُمرّرstartIndex، في حال كان ذلك الحرف غير موجود فستعيد العدد -1.