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