الفرق بين المراجعتين ل"Kotlin/kotlin.text/findLastAnyOf"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<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>‎ عن أول ظهور لأي واحدة من [[Kotlin/String|السلاسل النصية]] الموجودة في الوسيط المُمرّر <code>strings</code>  في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس <code>startIndex،</code> وفي حال إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</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|السلسلة النصية]] عند ذلك الفهرس.   
+
لتجنّب الالتباس عندما تحتوي  [[Kotlin/String|السلاسل النصية]] الموجودة في الوسيط المُمرّر <code>strings</code> حروفا مشتركة، فإنّ  الدالة <code>findAnyOf()</code>‎ تبدأ من نهاية تلك [[Kotlin/String|السلسلة النصية]] نحو بدايتها، وتبحث عند كل موضع عن العنصر الأول في <code>strings</code>والذي يطابق تلك [[Kotlin/String|السلسلة النصية]] عند ذلك الموضع.   
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
fun CharSequence.findAnyOf(
+
fun CharSequence.findLastAnyOf(
 
     strings: Collection<String>,  
 
     strings: Collection<String>,  
     startIndex: Int = 0,  
+
     startIndex: Int = lastIndex,  
 
     ignoreCase: Boolean = false
 
     ignoreCase: Boolean = false
): Pair<Int, String>?
+
): Pair<Int, String>?  
 
</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: سطر 21:
 
val strings = listOf("kotlin", "wiki","ki", "sou", "xyz")
 
val strings = listOf("kotlin", "wiki","ki", "sou", "xyz")
 
      
 
      
println(str.findAnyOf(strings)) //  (1, sou)
+
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

مصادر