الفرق بين المراجعتين لصفحة: «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/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف غير موجود فستعيد العدد ‎<code>-1</code>.
+تجلب الدالة <code>indexOf()‎</code> فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
-في حال إعطاء الوسيط <code>ignoreCase</code>  القيمة <code>true</code> فإنّ الدالة <code>indexOf()‎</code> لن تفرق بين الحروف الكبيرة والصغيرة.
 == البنية العامة ==
-يمكن استدعاء  الدالة <code>indexOf()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
+<syntaxhighlight lang="kotlin">
 fun CharSequence.indexOf(
      char: Char,
@@ سطر 17: / سطر 15: @@
 ): Int
 </syntaxhighlight>
+== المعاملات ==
+=== <code>char</code> ===
+المحرف المراد البحث عنه ضمن [[Kotlin/CharSequence|سلسلة من المحارف]].
+=== <code>startIndex</code> ===
+السلسلة النصية المراد البحث عنها ضمن [[Kotlin/CharSequence|سلسلة من المحارف]].
+=== <code>ignoreCase</code> ===
+قيمة منطقية تحدد إن كان يراد إهمال حالة المحارف أثناء عملية البحث أم لا. القيمة الافتراضية هي: <code>false</code> (أي أخذ حالة المحارف بالحسبان).
 == القيم المعادة ==
-فهرس أول ظهور للعنصر المُمرّر أو  العدد ‎<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/String|سلسلة نصية]] باسم <code>str</code><nowiki/>، ثم تستخدم الدالة  <code>()indexOf</code>  للحصول على فهرس أول ظهور للحرفين <code>'x'</code> و<code>'s'</code> ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-var str = "hsoub"
+    var str = "hsoub"
-print(str.indexOf('s')) // 1
-print(str.indexOf('x')) // -1
+    print(str.indexOf('s')) // 1
+    print(str.indexOf('x')) // -1
 }
-</syntaxhighlight>
+</syntaxhighlight><nowiki/>مثالٌ آخر على استعمال الدالة <code>()indexOf</code> للبحث عن سلسلة نصية:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+    var str = "hsoub"
-=== استخدام  الدالة<code>()indexOf</code>مع سلسلة نصية مع تمرير سلسلة نصية كوسيط  ===
+     print(str.indexOf("sou", 2, true)) // -1
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستخدم الدالة  <code>()indexOf</code>  للحصول على فهرس أول ظهور  [[Kotlin/String|للسلسلتين النصيتين]]<code>"sou"</code> و<code>"sx"</code> ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+    print(str.indexOf("sx", 1)) // -1
-fun main(args: Array<String>) {
-var str = "hsoub"
-print(str.indexOf("sou")) // 1
-print(str.indexOf("sx")) // -1
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny]]()‎</code>: تعيد  فهرس أول ظهور للحرف أو [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر <code>startIndex</code>، في حال كان ذلك الحرف أو تلك  [[Kotlin/String|السلسلة النصية]] المُمرّرة غير موجودة فستعيد الدالةُ العدد ‎<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|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.
 == مصادر ==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/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]]