الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/findLastAnyOf»
< Kotlin | kotlin.text
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.findLastAnyOf()</code> في لغة Kotlin}}</noinclude> تبحث الدالة <code>findLastAnyOf()</code> عن...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>text.findLastAnyOf()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>text.findLastAnyOf()</code> في لغة Kotlin}}</noinclude> | ||
تبحث الدالة <code>findLastAnyOf()</code> عن | تبحث الدالة <code>findLastAnyOf()</code> عن آخر ظهور لأي واحدة من [[Kotlin/String|السلاسل النصية]] الموجودة في الوسيط المُمرّر <code>strings</code> في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس <code>startIndex</code>، وفي حال إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</code> فستتجاهل الدالة حالة الحروف. | ||
لتجنّب الالتباس عندما تحتوي [[Kotlin/String|السلاسل النصية]] الموجودة في الوسيط المُمرّر <code>strings</code> حروفا مشتركة، فإنّ الدالة <code>findAnyOf()</code> تبدأ من نهاية تلك [[Kotlin/String|السلسلة النصية]] نحو بدايتها، وتبحث عند كل موضع عن العنصر الأول في <code>strings</code>والذي يطابق تلك [[Kotlin/String|السلسلة النصية]] عند ذلك الموضع. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
fun CharSequence. | fun CharSequence.findLastAnyOf( | ||
strings: Collection<String>, | strings: Collection<String>, | ||
startIndex: Int = | startIndex: Int = lastIndex, | ||
ignoreCase: Boolean = false | ignoreCase: Boolean = false | ||
): Pair<Int, String>? | ): Pair<Int, String>? | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المعادة== | ==القيم المعادة== | ||
زوجا مكونًا من فهرس | [[Kotlin/Pair/index|زوجا]] مكونًا من فهرس آخر ظهور لأي واحدة من [[Kotlin/String|السلاسل النصية]] الموجودة في<code>strings</code> و [[Kotlin/String|السلسلة النصية]] المُطابقَة، أو تعيد <code>null</code> إن لم يوجد أي تطابق. | ||
==أمثلة== | ==أمثلة== | ||
| سطر 21: | سطر 21: | ||
val strings = listOf("kotlin", "wiki","ki", "sou", "xyz") | val strings = listOf("kotlin", "wiki","ki", "sou", "xyz") | ||
println(str. | println(str.findLastAnyOf(strings)) // (8, ki) | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* <code>[[Kotlin/kotlin.text/find|find()]]</code>: تعيد أول حرف من سلسلة الحروف التي استُدعيت عبرها يحقق الشرط المنطقي <code>predicate.</code> | * <code>[[Kotlin/kotlin.text/find|find()]]</code>: تعيد أول حرف من سلسلة الحروف التي استُدعيت عبرها يحقق الشرط المنطقي <code>predicate.</code> | ||
* <code>[[Kotlin/kotlin.text/findAnyOf|findAnyOf()]]</code>:تبحث الدالة <code>findAnyOf()</code> عن أول ظهور لأي واحدة من السلاسل النصية الموجودة في الوسيط المُمرّر <code>strings</code> في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس <code>startIndex،</code> وفي حال إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</code> فستتجاهل الدالة حالة الحروف. | |||
* <code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed()]]</code>: تعيد الدالة <code>filterIndexed()</code> كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()</code> ثم تعيد بدورها قيمة منطقيَّة. | * <code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed()]]</code>: تعيد الدالة <code>filterIndexed()</code> كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()</code> ثم تعيد بدورها قيمة منطقيَّة. | ||
| سطر 32: | سطر 34: | ||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/find-any-of.html الدالة text.findLastAnyOf() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/find-last-any-of.html الدالة text.findLastAnyOf() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 21:55، 8 يوليو 2018
تبحث الدالة findLastAnyOf() عن آخر ظهور لأي واحدة من السلاسل النصية الموجودة في الوسيط المُمرّر strings في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس startIndex، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف.
لتجنّب الالتباس عندما تحتوي السلاسل النصية الموجودة في الوسيط المُمرّر strings حروفا مشتركة، فإنّ الدالة findAnyOf() تبدأ من نهاية تلك السلسلة النصية نحو بدايتها، وتبحث عند كل موضع عن العنصر الأول في stringsوالذي يطابق تلك السلسلة النصية عند ذلك الموضع.
البنية العامة
fun CharSequence.findLastAnyOf(
strings: Collection<String>,
startIndex: Int = lastIndex,
ignoreCase: Boolean = false
): Pair<Int, String>?
القيم المعادة
زوجا مكونًا من فهرس آخر ظهور لأي واحدة من السلاسل النصية الموجودة فيstrings و السلسلة النصية المُطابقَة، أو تعيد null إن لم يوجد أي تطابق.
أمثلة
استخدام الدالة ()findLastAnyOf مع سلسلة نصية
تعرِّف الشيفرة الآتية سلسلة نصية باسم str، كما تعرّف لائحة من السلاسل النصية باسم strings، ثمَّ تستدعي الدالة()findLastAnyOf عبر str مع تمرير strings كوسيط، ثمَّ تطبع الناتج:
fun main(args: Array<String>) {
val str = "hsoub wiki"
val strings = listOf("kotlin", "wiki","ki", "sou", "xyz")
println(str.findLastAnyOf(strings)) // (8, ki)
}
انظر أيضًا
find(): تعيد أول حرف من سلسلة الحروف التي استُدعيت عبرها يحقق الشرط المنطقيpredicate.
findAnyOf():تبحث الدالةfindAnyOf() عن أول ظهور لأي واحدة من السلاسل النصية الموجودة في الوسيط المُمرّرstringsفي سلسلة الحروف التي استُدعيت عبرها بداية من الفهرسstartIndex،وفي حال إعطاء القيمةtrueللوسيطignoreCaseفستتجاهل الدالة حالة الحروف.
filterIndexed(): تعيد الدالةfilterIndexed() كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالةpredicate()ثم تعيد بدورها قيمة منطقيَّة.
elementAt(): تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناءIndexOutOfBoundsException.