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

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

تجلب الدالة 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

المعاملات

`char`

المحرف المراد البحث عنه ضمن سلسلة من المحارف.

`startIndex`

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

`ignoreCase`

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

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

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

أمثلة

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

fun main(args: Array<String>) {
    var str = "hsoub"

    print(str.indexOf('s')) // 1
    print(str.indexOf('x')) // -1
}

مثالٌ آخر على استعمال الدالة ()indexOf للبحث عن سلسلة نصية:

fun main(args: Array<String>) {
    var str = "hsoub"

    print(str.indexOf("sou", 2, true)) // -1
    print(str.indexOf("sx", 1)) // -1
}

انظر أيضًا

الدالة indexOfAny()‎: تجلب فهرس أول ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من سلسلة المحارف التي استُدعيت معها.
الدالة indexOfFirst()‎: تجلب فهرس أول محرف يحقِّق شرطًا معيَّنًا من سلسلة المحارف التي استُدعيت معها.
الدالة lastIndexOf()‎: تجلب فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها.
الدالة find()‎: تبحث على محرف يحقق شرطًا محدَّدًا ضمن محارف السلسلة التي استُدعيت معها ثمَّ تعيد أول ظهور له.
الدالة filter()‎: ترشِّح محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة text.indexOf()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.indexOf()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>indexOf()‎</code> فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
+تجلب الدالة <code>indexOf()‎</code> فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
 == البنية العامة ==
-يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
+<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>
+== المعاملات ==
+=== <code>char</code> ===
+المحرف المراد البحث عنه ضمن [[Kotlin/CharSequence|سلسلة من المحارف]].
+=== <code>startIndex</code> ===
+السلسلة النصية المراد البحث عنها ضمن [[Kotlin/CharSequence|سلسلة من المحارف]].
+=== <code>ignoreCase</code> ===
+قيمة منطقية تحدد إن كان يراد إهمال حالة المحارف أثناء عملية البحث أم لا. القيمة الافتراضية هي: <code>false</code> (أي أخذ حالة المحارف بالحسبان).
 == القيم المعادة ==
-فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
+يعاد عدد صحيح يمثل فهرس أول ظهور للمحرف <code>char</code> أو السلسلة النصية <code>string</code> في <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المعطاة، أو القيمة ‎-1 إن لم يُعثَر على شيء.
 == أمثلة ==
+<nowiki/><nowiki/>مثالٌ على استعمال الدالة <code>()indexOf</code> للبحث عن محارف:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة<code>indexOf()‎</code> على مصفوفة: الحالة الأولى ===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()indexOf</code>  للحصول على فهرس أول ظهور للعدد <code>4</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val array = arrayOf(1,2,3,4,5,6)
+     var str = "hsoub"
-     print(array.indexOf(4)) // 3
+     print(str.indexOf('s')) // 1
+    print(str.indexOf('x')) // -1
 }
-</syntaxhighlight>
+</syntaxhighlight><nowiki/>مثالٌ آخر على استعمال الدالة <code>()indexOf</code> للبحث عن سلسلة نصية:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة<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">
 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", 2, true)) // -1
+    print(str.indexOf("sx", 1)) // -1
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]()‎</code>: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
+* الدالة <code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny()‎]]</code>: تجلب فهرس أول ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
+* الدالة <code>[[Kotlin/kotlin.text/indexOfFirst|indexOfFirst()‎]]</code>: تجلب فهرس أول محرف يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
+* الدالة <code>[[Kotlin/kotlin.text/lastIndexOf|lastIndexOf()‎]]</code>: تجلب فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
+* الدالة <code>[[Kotlin/kotlin.text/find|find()‎]]</code>: تبحث على محرف يحقق شرطًا محدَّدًا ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له.
+* الدالة <code>[[Kotlin/kotlin.text/filter|filter()‎]]</code>: ترشِّح محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.
 == مصادر ==
-* [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 صفحة الدالة CharSequence.indexOf()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Methods]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]