الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/findAnyOf»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
تبحث الدالة <code>findAnyOf()</code> عن أول ظهور لأي واحدة من [[Kotlin/String|السلاسل النصية]] الموجودة في الوسيط المُمرّر <code>strings</code> في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس <code>startIndex،</code> وفي حال إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</code> فستتجاهل الدالة حالة الحروف. | تبحث الدالة <code>findAnyOf()</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|السلسلة النصية]] | لتجنب الالتباس عندما تحتوي [[Kotlin/String|السلاسل النصية]] الموجودة في الوسيط المُمرّر <code>strings</code> حروفا مشتركة، فإنّ الدالة <code>findAnyOf()</code> تبدأ من بداية تلك [[Kotlin/String|السلسلة النصية]] نحو نهايتها، وتبحث عند كل موضع عن العنصر الأول في <code>strings</code>والذي يطابق تلك [[Kotlin/String|السلسلة النصية]] عند ذلك الموضع. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 12: | سطر 12: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المعادة== | ==القيم المعادة== | ||
زوجا مكونًا من فهرس أول ظهور لأي واحدة من [[Kotlin/String|السلاسل النصية]] الموجودة في<code>strings</code> و [[Kotlin/String|السلسلة النصية]] المُطابقَة، أو تعيد <code>null</code> إن لم يوجد أي تطابق. | [[Kotlin/Pair/index|زوجا]] مكونًا من فهرس أول ظهور لأي واحدة من [[Kotlin/String|السلاسل النصية]] الموجودة في<code>strings</code> و [[Kotlin/String|السلسلة النصية]] المُطابقَة، أو تعيد <code>null</code> إن لم يوجد أي تطابق. | ||
==أمثلة== | ==أمثلة== | ||
مراجعة 21:55، 8 يوليو 2018
تبحث الدالة findAnyOf() عن أول ظهور لأي واحدة من السلاسل النصية الموجودة في الوسيط المُمرّر strings في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس startIndex، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف.
لتجنب الالتباس عندما تحتوي السلاسل النصية الموجودة في الوسيط المُمرّر strings حروفا مشتركة، فإنّ الدالة findAnyOf() تبدأ من بداية تلك السلسلة النصية نحو نهايتها، وتبحث عند كل موضع عن العنصر الأول في stringsوالذي يطابق تلك السلسلة النصية عند ذلك الموضع.
البنية العامة
fun CharSequence.findAnyOf(
strings: Collection<String>,
startIndex: Int = 0,
ignoreCase: Boolean = false
): Pair<Int, String>?
القيم المعادة
زوجا مكونًا من فهرس أول ظهور لأي واحدة من السلاسل النصية الموجودة فيstrings و السلسلة النصية المُطابقَة، أو تعيد null إن لم يوجد أي تطابق.
أمثلة
استخدام الدالة ()findAnyOf مع سلسلة نصية
تعرِّف الشيفرة الآتية سلسلة نصية باسم str، كما تعرّف لائحة من السلاسل النصية باسم strings، ثمَّ تستدعي الدالة()findAnyOf عبر str مع تمرير strings كوسيط، ثمَّ تطبع الناتج:
fun main(args: Array<String>) {
val str = "hsoub wiki"
val strings = listOf("kotlin", "wiki","ki", "sou", "xyz")
println(str.findAnyOf(strings)) // (1, sou)
}
انظر أيضًا
find(): تعيد أول حرف من سلسلة الحروف التي استُدعيت عبرها يحقق الشرط المنطقيpredicate.
filterIndexed(): تعيد الدالةfilterIndexed() كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالةpredicate()ثم تعيد بدورها قيمة منطقيَّة.
elementAt(): تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناءIndexOutOfBoundsException.