الفرق بين المراجعتين ل"Kotlin/collections/indexOf"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة indexOf() في لغة Kotlin}}</noinclude> تعيد الدالة <code>indexOf()</code> قيمة العنصر عند الف...') |
|||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة indexOf() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة indexOf() في لغة Kotlin}}</noinclude> | ||
− | تعيد الدالة <code>indexOf()</code> | + | تعيد الدالة <code>indexOf()</code> فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها ، أو <code>-1</code> إن كان العنصر المُمرّر غير موجود. |
== البنية العامة == | == البنية العامة == | ||
يمكن استدعاء الدالة <code>indexOf()</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin"> | يمكن استدعاء الدالة <code>indexOf()</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin"> | ||
− | fun <T> Array<out T>. | + | fun <T> Array<out T>.indexOf(element: T): Int |
− | fun ByteArray. | + | fun ByteArray.indexOf(element: Byte): Int |
− | fun ShortArray. | + | fun ShortArray.indexOf(element: Short): Int |
− | fun IntArray. | + | fun IntArray.indexOf(element: Int): Int |
− | fun LongArray. | + | fun LongArray.indexOf(element: Long): Int |
− | fun FloatArray. | + | fun FloatArray.indexOf(element: Float): Int |
− | fun DoubleArray. | + | fun DoubleArray.indexOf(element: Double): Int |
− | fun BooleanArray. | + | fun BooleanArray.indexOf(element: Boolean): Int |
− | fun CharArray. | + | 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>يمكن استدعاء الدالة <code>indexOf()</code> عبر [[Kotlin/collections|اللوائح]]:<syntaxhighlight lang="kotlin"> |
− | fun <T> List<T>. | + | fun <T> List<T>.indexOf(element: T): Int |
</syntaxhighlight> | </syntaxhighlight> | ||
+ | |||
== القيم المعادة == | == القيم المعادة == | ||
− | + | فهرس أول ظهور للعنصر المُمرّر إليها في [[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> للحصول على | + | تعرف الشيفرة الآتية <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) | val array = arrayOf(1,2,3,4,5,6) | ||
− | print(array. | + | 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> للحصول على | + | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()indexOf</code> للحصول على فهرس أول ظهور للعدد <code>4</code>، <nowiki/>ولمّا كان هذا العدد غير موجود في المصفوفة، فستعيد الدالة <code>()getOrNull</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) | val array = arrayOf(1,2,3,4,5,6) | ||
− | print(array. | + | print(array.indexOf(14)) // -1 |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
− | * <code>[[Kotlin/collections/ | + | * <code>[[Kotlin/collections/indexOfFirst|indexOfFirst]]()</code>: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر، أو <code>-1</code> إن كان العنصر المُمرّر غير موجود. |
== مصادر == | == مصادر == | ||
− | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/ | + | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of.html الدالة indexOf() في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Methods]] | [[تصنيف:Kotlin Methods]] |
مراجعة 15:30، 27 مايو 2018
تعيد الدالة indexOf()
فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها ، أو -1
إن كان العنصر المُمرّر غير موجود.
البنية العامة
يمكن استدعاء الدالة indexOf()
عبر المصفوفات:
fun <T> Array<out T>.indexOf(element: T): Int
fun ByteArray.indexOf(element: Byte): Int
fun ShortArray.indexOf(element: Short): Int
fun IntArray.indexOf(element: Int): Int
fun LongArray.indexOf(element: Long): 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
يمكن استدعاء الدالة indexOf()
عبر المجموعات:
fun <T> Iterable<T>.indexOf(element: T): Int
يمكن استدعاء الدالة indexOf()
عبر اللوائح:
fun <T> List<T>.indexOf(element: T): Int
القيم المعادة
فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها ، أو -1
إن كان العنصر المُمرّر غير موجود.
أمثلة
استخدام الدالةindexOf()
على مصفوفة: الحالة الأولى
تعرف الشيفرة الآتية مصفوفة باسم array
مكونة من ستة أعداد باستخدام الدالة ()arrayOf
، ثم تستخدم الدالة ()indexOf
للحصول على فهرس أول ظهور للعدد 4
، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
print(array.indexOf(4)) // 3
}
استخدام الدالةindexOf()
على مصفوفة: الحالة الثانية
تعرف الشيفرة الآتية مصفوفة باسم array
مكونة من ستة أعداد باستخدام الدالة ()arrayOf
، ثم تستخدم الدالة ()indexOf
للحصول على فهرس أول ظهور للعدد 4
، ولمّا كان هذا العدد غير موجود في المصفوفة، فستعيد الدالة ()getOrNull
القيمة -1
:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
print(array.indexOf(14)) // -1
}
انظر أيضًا
indexOfFirst()
: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر، أو -1
إن كان العنصر المُمرّر غير موجود.