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

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

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

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

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

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

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

حرف.

أمثلة

استخدام الدالة `()find` مع سلسلة نصية

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

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

انظر أيضًا

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

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

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

مصادر

الدالة text.find()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.find()‎</code> في لغة Kotlin}}</noinclude>
-تضيف الدالة <code>find()</code>‎ كل الحروف من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والتي تحقق الشرط المنطقي <code>predicate</code> إلى الوسيط المُمرّر <code>destination.</code>
+تعيد الدالة <code>find()</code>‎ أول [[Kotlin/Char/index|حرف]] من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها يحقق الشرط المنطقي <code>predicate</code><code>.</code>
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun <C> CharSequence.filterTo(
+inline fun CharSequence.find(
-    destination: C,
      predicate: (Char) -> Boolean
-): C
+): Char?
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المعادة==
-الوسيط المُمرّر <code>destination</code>.
+[[Kotlin/Char/index|حرف]].
 ==أمثلة==
 ===استخدام الدالة <code>()find</code> مع سلسلة نصية===
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، وتعرّف كائنا من الصنف [[Kotlin/kotlin.text/StringBuilder/index|<code>StringBuilder</code>]] باسم <code>sb</code>، ثمَّ تستدعي الدالة  <code>()find</code> عبرها مع تمرير <code>sb</code> ودالة منطقية كوسيطين، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()find</code> عبرها مع تمرير دالة منطقية كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
 val str = "abcdef"
-val sb = StringBuilder()
-str.filterTo (sb) {it<'c'}
-println(sb) //  ab
+println(str.find{it > 'c'}) //  d
 }
 </syntaxhighlight>
@@ سطر 32: / سطر 28: @@
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/filter-to.html الدالة text.find()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/find.html الدالة text.find()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]