الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/indexOfAny»

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة text.indexOfAny()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>indexOfAny()‎</code> فهرس أول ظهور...'
 
طلا ملخص تعديل
 
(6 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة text.indexOfAny()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.indexOfAny()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>indexOfAny()‎</code> فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف غير موجود فستعيد العدد ‎<code>-1</code>.
تجلب الدالة <code>indexOfAny()‎</code> فهرس أول ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
 
==البنية العامة==
في حال إعطاء الوسيط  القيمة <code>true</code> فإنّ الدالة <code>indexOf()‎</code> لن تفرق بين الحروف الكبيرة والصغيرة.
<syntaxhighlight lang="kotlin">
== البنية العامة ==
fun CharSequence.indexOfAny(
يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
     chars: CharArray,  
fun CharSequence.indexOf(
     startIndex: Int = lastIndex,  
     char: Char,  
     startIndex: Int = 0,  
     ignoreCase: Boolean = false
     ignoreCase: Boolean = false
): Int
): Int


fun CharSequence.indexOf(
fun CharSequence.indexOfAny(
     string: String,  
     strings: Collection<String>,  
     startIndex: Int = 0,  
     startIndex: Int = lastIndex,  
     ignoreCase: Boolean = false
     ignoreCase: Boolean = false
): Int  
): Int
</syntaxhighlight>
</syntaxhighlight>
== القيم المعادة ==
فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
== أمثلة ==


=== استخدام  الدالة<code>()indexOfAny</code>مع سلسلة نصية مع تمرير حرف كوسيط  ===
== المعاملات ==
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code><nowiki/>، ثم تستخدم الدالة  <code>()indexOfAny</code>  للحصول على فهرس أول ظهور للحرفين <code>'x'</code> و<code>'s'</code> ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
=== <code>chars</code> ===
[[Kotlin/CharArray|مصفوفة من المحارف]] التي يراد البحث عنها ضمن سلسلة المحارف المعطاة.
 
=== <code>strings</code> ===
مجموعةٌ من سلاسل نصية يراد البحث عنها ضمن سلسلة المحارف المعطاة.
 
لتجنب الالتباس الناتج عند وجود محارف مشتركة بين السلاسل النصية الموجودة في المعامل <code>strings</code>، فإنّ الدالة <code>indexOfAny()</code>‎ تبدأ من بداية سلسلة المحارف المعطاة وحتى نهايتها باحثةً عن العنصر الأول في <code>strings</code> ثم الثاني ثم الثالث ...إلخ. عند كل محرف من محارفها لمطابقة أول ظهور لأحد العناصر في سلسلة المحارف المعطاة .
 
=== <code>startIndex</code> ===
عدد صحيح يمثل فهرس العنصر الذي يراد بدء عملية البحث عنده. القيمة الافتراضية هي: 0 (أي بدء عملية البحث من بداية سلسلة المحارف).
 
=== <code>ignorCase</code> ===
قيمة منطقية تحدد إن كان يراد تجاهل حالة المحارف أم لا أثناء عملية البحث. القيمة الافتراضية هي: <code>false</code> أي أخذ حالة الحروف بالحسبان.
 
==القيم المعادة==
يعاد عدد صحيح يمثل فهرس أول ظهور لأحد المحارف <code>chars</code> أو السلاسل النصية <code>strings</code> في سلسلة المحارف المعطاة، أو تعاد القيمة 1- إن لم يُعثَر على شيء.
==أمثلة==
<nowiki/>مثالٌ على استعمال الدالة <code>()indexOf</code> للبحث عن أول ظهور لأحد المحارف ضمن سلسلة من المحارف:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
var str = "hsoub"
    var str = "hsoub"
      
     var chars = charArrayOf('x', 'r', 'b')
print(str.indexOf('s')) // 1
print(str.indexOf('x')) // -1


    print(str.indexOfAny(chars)) // 4
}
}
</syntaxhighlight>
</syntaxhighlight>
<nowiki/>مثالٌ على استعمال الدالة <code>()indexOf</code> لبحث عن أول ظهور لأحد السلاسل النصية ضمن سلسلة من المحارف:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    var str = "hsoub"
    var chars = charArrayOf('x', 'r', 'w')


=== استخدام  الدالة<code>()indexOfAny</code>مع سلسلة نصية مع تمرير سلسلة نصية كوسيط  ===
     print(str.indexOfAny(chars)) // -1
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستخدم الدالة  <code>()indexOfAny</code>  للحصول على فهرس أول ظهور  [[Kotlin/String|للسلسلتين النصيتين]]<code>"sou"</code> و<code>"sx"</code> ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
var str = "hsoub"
      
print(str.indexOf("sou")) // 1
print(str.indexOf("sx")) // -1
}
}
</syntaxhighlight>
</syntaxhighlight>
== انظر أيضًا ==
==انظر أيضًا==
* <code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]()‎</code>: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
*الدالة <code>[[Kotlin/kotlin.text/indexOf|indexOf()‎]]</code>: تجلب فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. 
 
*الدالة <code>[[Kotlin/kotlin.text/indexOfFirst|indexOfFirst()‎]]</code>: تجلب فهرس أول محرف يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. 
== مصادر ==
*الدالة <code>[[Kotlin/kotlin.text/lastIndexOfAny|lastIndexOfAny()‎]]</code>: تجلب فهرس آخر ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index-of.html الدالة text.indexOfAny()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
* الدالة <code>[[Kotlin/kotlin.text/findAnyOf|findAnyOf()]]‎</code>: تبحث عن أول ظهور لأيٍّ من السلاسل النصية المعطاة في <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index-of-any.html صفحة الدالة text.indexOfAny()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin CharSequence]]

المراجعة الحالية بتاريخ 07:32، 4 سبتمبر 2018

تجلب الدالة indexOfAny()‎ فهرس أول ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من سلسلة المحارف التي استُدعيت معها.

البنية العامة

fun CharSequence.indexOfAny(
    chars: CharArray, 
    startIndex: Int = lastIndex, 
    ignoreCase: Boolean = false
): Int

fun CharSequence.indexOfAny(
    strings: Collection<String>, 
    startIndex: Int = lastIndex, 
    ignoreCase: Boolean = false
): Int

المعاملات

chars

مصفوفة من المحارف التي يراد البحث عنها ضمن سلسلة المحارف المعطاة.

strings

مجموعةٌ من سلاسل نصية يراد البحث عنها ضمن سلسلة المحارف المعطاة.

لتجنب الالتباس الناتج عند وجود محارف مشتركة بين السلاسل النصية الموجودة في المعامل strings، فإنّ الدالة indexOfAny()‎ تبدأ من بداية سلسلة المحارف المعطاة وحتى نهايتها باحثةً عن العنصر الأول في strings ثم الثاني ثم الثالث ...إلخ. عند كل محرف من محارفها لمطابقة أول ظهور لأحد العناصر في سلسلة المحارف المعطاة .

startIndex

عدد صحيح يمثل فهرس العنصر الذي يراد بدء عملية البحث عنده. القيمة الافتراضية هي: 0 (أي بدء عملية البحث من بداية سلسلة المحارف).

ignorCase

قيمة منطقية تحدد إن كان يراد تجاهل حالة المحارف أم لا أثناء عملية البحث. القيمة الافتراضية هي: false أي أخذ حالة الحروف بالحسبان.

القيم المعادة

يعاد عدد صحيح يمثل فهرس أول ظهور لأحد المحارف chars أو السلاسل النصية strings في سلسلة المحارف المعطاة، أو تعاد القيمة 1- إن لم يُعثَر على شيء.

أمثلة

مثالٌ على استعمال الدالة ()indexOf للبحث عن أول ظهور لأحد المحارف ضمن سلسلة من المحارف:

fun main(args: Array<String>) {
    var str = "hsoub"
    var chars = charArrayOf('x', 'r', 'b')

    print(str.indexOfAny(chars)) // 4
}

مثالٌ على استعمال الدالة ()indexOf لبحث عن أول ظهور لأحد السلاسل النصية ضمن سلسلة من المحارف:

fun main(args: Array<String>) {
    var str = "hsoub"
    var chars = charArrayOf('x', 'r', 'w')

    print(str.indexOfAny(chars)) // -1
}

انظر أيضًا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/indexOfAny&oldid=16449»