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

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