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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة text.indexOf()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>indexOf()‎</code> فهرس أول ظهور لل...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة text.indexOf()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة text.indexOf()‎ في لغة Kotlin}}</noinclude>
تعيد الدالة <code>indexOf()‎</code> فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
تعيد الدالة <code>indexOf()‎</code> فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف غير موجود فستعيد العدد ‎<code>-1</code>.
 
في حال إعطاء الوسيط  القيمة <code>true</code> فإنّ الدالة <code>indexOf()‎</code> لن تفرق بين الحروف الكبيرة والصغيرة.
== البنية العامة ==
== البنية العامة ==
يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
fun <T> Array<out T>.indexOf(element: T): Int
fun CharSequence.indexOf(
fun ByteArray.indexOf(element: Byte): Int
    char: Char,
fun ShortArray.indexOf(element: Short): Int
    startIndex: Int = 0,
fun IntArray.indexOf(element: Int): Int
    ignoreCase: Boolean = false
fun LongArray.indexOf(element: Long): Int
): Int
fun FloatArray.indexOf(element: Float): Int
fun DoubleArray.indexOf(element: Double): Int  
fun BooleanArray.indexOf(element: Boolean): Int
fun CharArray.indexOf(element: Char): Int
</syntaxhighlight>يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
fun <T> Iterable<T>.indexOf(element: T): Int  


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


=== استخدام الدالة<code>indexOf()</code> على مصفوفة: الحالة الأولى ===
=== استخدام الدالة<code>()indexOf</code>مع سلسلة نصية مع تمرير حرف كوسيط  ===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()indexOf</code>  للحصول على فهرس أول ظهور للعدد <code>4</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code><nowiki/>، ثم تستخدم الدالة  <code>()indexOf</code>  للحصول على فهرس أول ظهور للحرفين <code>'x'</code> و<code>'s'</code> ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
     val array = arrayOf(1,2,3,4,5,6)
var str = "hsoub"
      
print(str.indexOf('s')) // 1
print(str.indexOf('x')) // -1


    print(array.indexOf(4)) // 3
}
}
</syntaxhighlight>
</syntaxhighlight>


=== استخدام الدالة<code>indexOf()</code> على مصفوفة: الحالة الثانية ===
=== استخدام الدالة<code>()indexOf</code>مع سلسلة نصية مع تمرير سلسلة نصية كوسيط  ===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()indexOf</code> للحصول على فهرس أول ظهور للعدد <code>4</code>، <nowiki/>ولمّا كان هذا العدد غير موجود في المصفوفة، فستعيد الدالة <code>()indexOf</code> القيمة ‎<code>-1‎‎</code>:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستخدم الدالة  <code>()indexOf</code>  للحصول على فهرس أول ظهور [[Kotlin/String|للسلسلتين النصيتين]]<code>"sou"</code> و<code>"sx"</code> ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
     val array = arrayOf(1,2,3,4,5,6)
var str = "hsoub"
 
      
    print(array.indexOf(14)) // -1
print(str.indexOf("sou")) // 1
print(str.indexOf("sx")) // -1
}
}
</syntaxhighlight>
</syntaxhighlight>
سطر 44: سطر 45:


== مصادر ==
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of.html الدالة text.indexOf()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index-of.html الدالة text.indexOf()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Methods]]

مراجعة 19:29، 9 يوليو 2018

تعيد الدالة indexOf()‎ فهرس أول ظهور للحرف أو السلسلة النصية المُمرّرة إليها في سلسلة الحروف التي استُدعيت عبرها بداية من الفهرس المُمرّر startIndex، في حال كان ذلك الحرف غير موجود فستعيد العدد ‎-1.

في حال إعطاء الوسيط القيمة true فإنّ الدالة indexOf()‎ لن تفرق بين الحروف الكبيرة والصغيرة.

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

يمكن استدعاء الدالة indexOf()‎ عبر المصفوفات:

fun CharSequence.indexOf(
    char: Char, 
    startIndex: Int = 0, 
    ignoreCase: Boolean = false
): Int

fun CharSequence.indexOf(
    string: String, 
    startIndex: Int = 0, 
    ignoreCase: Boolean = false
): Int

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

فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها ، أو ‎-1‎ إن كان العنصر المُمرّر غير موجود.

أمثلة

استخدام الدالة()indexOfمع سلسلة نصية مع تمرير حرف كوسيط

تعرف الشيفرة الآتية سلسلة نصية باسم str، ثم تستخدم الدالة  ()indexOf  للحصول على فهرس أول ظهور للحرفين 'x' و's' ، ثم تطبع الناتج:

fun main(args: Array<String>) {
var str = "hsoub"
    
print(str.indexOf('s')) // 1
print(str.indexOf('x')) // -1

}

استخدام الدالة()indexOfمع سلسلة نصية مع تمرير سلسلة نصية كوسيط

تعرف الشيفرة الآتية سلسلة نصية باسم str، ثم تستخدم الدالة  ()indexOf  للحصول على فهرس أول ظهور للسلسلتين النصيتين"sou" و"sx" ، ثم تطبع الناتج:

fun main(args: Array<String>) {
var str = "hsoub"
    
print(str.indexOf("sou")) // 1
print(str.indexOf("sx")) // -1
}

انظر أيضًا

  • indexOfFirst()‎: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر، أو ‎-1‎ إن كان العنصر المُمرّر غير موجود.

مصادر