الفرق بين المراجعتين ل"Kotlin/kotlin.text/indexOf"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة text.indexOf()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>indexOf()‎</code> فهرس أول ظهور لل...')
 
ط
 
(6 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 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>
 
</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>) {
 
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>) {
 
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>
 
</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]]
−
[[تصنيف:Kotlin Methods]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin CharSequence]]

المراجعة الحالية بتاريخ 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()‎: ترشِّح محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/indexOf&oldid=16447"