الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/find»
< Kotlin | kotlin.text
ط استبدال النص - 'Kotlin Functions' ب'Kotlin Function' |
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>text.find()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>text.find()</code> في لغة Kotlin}}</noinclude> | ||
تبحث الدالة <code>find()</code> على محرف يحقق شرطًا محدَّدًا ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 6: | سطر 6: | ||
predicate: (Char) -> Boolean | predicate: (Char) -> Boolean | ||
): Char? | ): Char? | ||
</syntaxhighlight> | </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). | ||
== المعاملات == | |||
=== <code>predicate</code> === | |||
دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة. يمرر إلى هذه الدالة قيمة المحرف وتعيد قيمةً منطقيةً. | |||
==القيم المعادة== | ==القيم المعادة== | ||
[[Kotlin/ | يعاد أول ظهور للمحرف المبحوث عنه ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] المعطاة والذي يحقق الشرط <code>predicate</code> المعطى أيضًا، أو تعاد القيمة <code>null</code> إن لم يُعثر على أي عنصر يحقق ذلك الشرط. | ||
==أمثلة== | ==أمثلة== | ||
مثالٌ على استعمال الدالة <code>()find</code><nowiki/>:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val str = " | val str = "abcdefabc" | ||
println(str.find{it > 'c'}) // | println(str.find{ it > 'c' }) // d | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 28: | سطر 32: | ||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/find.html الدالة | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/find.html صفحة الدالة CharSequence.find() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Function]] | [[تصنيف:Kotlin Function]] | ||
مراجعة 08:02، 3 سبتمبر 2018
تبحث الدالة find() على محرف يحقق شرطًا محدَّدًا ضمن محارف السلسلة التي استُدعيت معها ثمَّ تعيد أول ظهور له.
البنية العامة
inline fun CharSequence.find(
predicate: (Char) -> Boolean
): Char?
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).
المعاملات
predicate
دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف السلسلة المعطاة. يمرر إلى هذه الدالة قيمة المحرف وتعيد قيمةً منطقيةً.
القيم المعادة
يعاد أول ظهور للمحرف المبحوث عنه ضمن محارف السلسلة المعطاة والذي يحقق الشرط predicate المعطى أيضًا، أو تعاد القيمة null إن لم يُعثر على أي عنصر يحقق ذلك الشرط.
أمثلة
مثالٌ على استعمال الدالة ()find:
fun main(args: Array<String>) {
val str = "abcdefabc"
println(str.find{ it > 'c' }) // d
}
انظر أيضًا
findAnyOf():تبحث الدالةfindAnyOf() عن أول ظهور لأي واحدة من السلاسل النصية الموجودة في الوسيط المُمرّرstringsفي سلسلة الحروف التي استُدعيت عبرها بداية من الفهرسstartIndex،وفي حال إعطاء القيمةtrueللوسيطignoreCaseفستتجاهل الدالة حالة الحروف.
filterIndexed(): تعيد الدالةfilterIndexed() كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالةpredicate()ثم تعيد بدورها قيمة منطقيَّة.
elementAt(): تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناءIndexOutOfBoundsException.