الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/indexOfFirst»

المراجعة الحالية بتاريخ 05:17، 4 سبتمبر 2018

تجلب الدالة indexOfFirst()‎ فهرس أول محرف يحقِّق شرطًا معيَّنًا من سلسلة المحارف التي استُدعيت معها.

البنية العامة

inline fun CharSequence.indexOfFirst(
    predicate: (Char) -> Boolean
): Int

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة (inline functions)).

المعاملات

`predicate`

دالةٌ تمثل الشرط الذي سيطبَّق على كل محرف من محارف السلسلة المعطاة، إذ يمرر إليها المحرف ثم تعيد قيمة منطقية مقابلة له.

القيم المعادة

يُعاد عدد صحيح يمثل فهرس أول محرف حقَّق الشرط المنطقي predicate المعطى في سلسلة المحارف المعطاة، أو القيمة ‎-1 إن لم يتطابق أيُّ عنصرٍ مع ذلك الشرط.

أمثلة

مثالٌ على استعمال الدالة ()indexOfFirst:

fun main(args: Array<String>) {
    var str = "hsoub"

    print(str.indexOfFirst { it > 'm' }) // 1
    print(str.indexOfFirst { it > 'x' }) // -1
}

انظر أيضًا

الدالة indexOf()‎: تجلب فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها.

الدالة indexOfAny()‎: تجلب فهرس أول ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من سلسلة المحارف التي استُدعيت معها.
الدالة indexOfLast()‎: تجلب فهرس آخر محرف يحقِّق شرطًا معيَّنًا من سلسلة المحارف التي استُدعيت معها.
الدالة first()‎: تجلب أول محرف من محارف السلسلة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
الدالة find()‎: تبحث على محرف يحقق شرطًا محدَّدًا ضمن محارف السلسلة التي استُدعيت معها ثمَّ تعيد أول ظهور له.

مصادر

صفحة الدالة CharSequence.indexOfFirst()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة text.indexOfFirst()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.indexOfFirst()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>indexOfFirst()‎</code> فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف غير موجود فستعيد العدد ‎<code>-1</code>.
+تجلب الدالة <code>indexOfFirst()‎</code> فهرس أول محرف يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
-في حال إعطاء الوسيط <code>ignoreCase</code>  القيمة <code>true</code> فإنّ الدالة <code>indexOf()‎</code> لن تفرق بين الحروف الكبيرة والصغيرة.
 == البنية العامة ==
-يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
+<syntaxhighlight lang="kotlin">
-fun CharSequence.indexOf(
+inline fun CharSequence.indexOfFirst(
-     char: Char,
+     predicate: (Char) -> Boolean
-    startIndex: Int = 0,
-    ignoreCase: Boolean = false
 ): Int
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>predicate</code> ===
+دالةٌ تمثل الشرط الذي سيطبَّق على كل محرف من محارف السلسلة المعطاة، إذ يمرر إليها المحرف ثم تعيد قيمة منطقية مقابلة له.
-fun CharSequence.indexOf(
-    string: String,
-    startIndex: Int = 0,
-    ignoreCase: Boolean = false
-): Int
-</syntaxhighlight>
 == القيم المعادة ==
-فهرس أول ظهور للعنصر المُمرّر أو  العدد ‎<code>-1</code>.
+يُعاد عدد صحيح يمثل فهرس أول محرف حقَّق الشرط المنطقي <code>predicate</code> المعطى في سلسلة المحارف المعطاة، أو القيمة ‎-1 إن لم يتطابق أيُّ عنصرٍ مع ذلك الشرط.
 == أمثلة ==
+<nowiki/><nowiki/>مثالٌ على استعمال الدالة <code>()indexOfFirst</code>:<syntaxhighlight lang="kotlin">
-=== استخدام  الدالة<code>()indexOfFirst</code>مع سلسلة نصية مع تمرير حرف كوسيط  ===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code><nowiki/>، ثم تستخدم الدالة  <code>()indexOfFirst</code>  للحصول على فهرس أول ظهور للحرفين <code>'x'</code> و<code>'s'</code> ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-var str = "hsoub"
+    var str = "hsoub"
-print(str.indexOf('s')) // 1
-print(str.indexOf('x')) // -1
+    print(str.indexOfFirst { it > 'm' }) // 1
+    print(str.indexOfFirst { it > 'x' }) // -1
 }
 </syntaxhighlight>
-=== استخدام  الدالة<code>()indexOfFirst</code>مع سلسلة نصية مع تمرير سلسلة نصية كوسيط  ===
+== <nowiki/>انظر أيضًا  ==
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستخدم الدالة  <code>()indexOfFirst</code>  للحصول على فهرس أول ظهور  [[Kotlin/String|للسلسلتين النصيتين]]<code>"sou"</code> و<code>"sx"</code> ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+* الدالة <code>[[Kotlin/kotlin.text/indexOf|indexOf()‎]]</code>: تجلب فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
-fun main(args: Array<String>) {
-var str = "hsoub"
+* الدالة <code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny()‎]]</code>: تجلب فهرس أول ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
+* الدالة <code>[[Kotlin/kotlin.text/indexOfLast|indexOfLast()‎]]</code>: تجلب فهرس آخر محرف يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
-print(str.indexOf("sou")) // 1
+* الدالة <code>[[Kotlin/kotlin.text/first|first()‎]]</code>: تجلب أول محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
-print(str.indexOf("sx")) // -1
+* الدالة <code>[[Kotlin/kotlin.text/find|find()‎]]</code>: تبحث على محرف يحقق شرطًا محدَّدًا ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له.
-}
-</syntaxhighlight>
-== انظر أيضًا ==
-* <code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny]]()‎</code>: تعيد  فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف أو تلك  [[Kotlin/String|السلسلة النصية]] المُمرّرة غير موجودة فستعيد الدالةُ العدد ‎<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 صفحة الدالة CharSequence.indexOfFirst()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Methods]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]