الفرق بين المراجعتين ل"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‎ إن كان العنصر المُمرّر غير موجود.

مصادر