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

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

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

في حال إعطاء الوسيط ignoreCase القيمة 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
}

انظر أيضًا

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

مصادر

الدالة text.indexOf()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.

@@ سطر 2: / سطر 2: @@
 تعيد الدالة <code>indexOf()‎</code> فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف غير موجود فستعيد العدد ‎<code>-1</code>.
-في حال إعطاء الوسيط  القيمة <code>true</code> فإنّ الدالة <code>indexOf()‎</code> لن تفرق بين الحروف الكبيرة والصغيرة.
+في حال إعطاء الوسيط <code>ignoreCase</code>  القيمة <code>true</code> فإنّ الدالة <code>indexOf()‎</code> لن تفرق بين الحروف الكبيرة والصغيرة.
 == البنية العامة ==
 يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
@@ سطر 18: / سطر 18: @@
 </syntaxhighlight>
 == القيم المعادة ==
-فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
+فهرس أول ظهور للعنصر المُمرّر أو  العدد ‎<code>-1</code>.
 == أمثلة ==
@@ سطر 42: / سطر 42: @@
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]()‎</code>: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
+* <code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny]]()‎</code>: تعيد  فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف أو تلك  [[Kotlin/String|السلسلة النصية]] المُمرّرة غير موجودة فستعيد الدالةُ العدد ‎<code>-1</code>.
 == مصادر ==