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