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

مراجعة 21:55، 8 يوليو 2018

تعيد الدالة find()‎ أول حرف من سلسلة الحروف التي استُدعيت عبرها والذي يحقق الشرط المنطقي predicate، أو تعيد null إن لم يوجد أي تطابق.

inline fun CharSequence.find(
    predicate: (Char) -> Boolean
): Char?

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

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()find عبرها مع تمرير دالة منطقية كوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
val str = "abcdef" 
    
println(str.find{it > 'c'}) //  d
}

findAnyOf()‎:تبحث الدالة findAnyOf()‎ عن أول ظهور لأي واحدة من السلاسل النصية الموجودة في الوسيط المُمرّر strings في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس startIndex، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف.

filterIndexed()‎: تعيد الدالة filterIndexed()‎ كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالة predicate()‎ ثم تعيد بدورها قيمة منطقيَّة.

elementAt()‎: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء IndexOutOfBoundsException.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.find()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>find()</code>‎ أول [[Kotlin/Char/index|حرف]] من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها يحقق الشرط المنطقي <code>predicate</code><code>.</code>
+تعيد الدالة <code>find()</code>‎ أول [[Kotlin/Char/index|حرف]] من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate،</code> أو تعيد  <code>null</code> إن لم يوجد أي تطابق.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">