الفرق بين المراجعتين لصفحة: «Kotlin/collections/elementAtOrNull»

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
طلا ملخص تعديل
إضافةقسم المعاملات.
 
(مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين)
سطر 19: سطر 19:


</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]).
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]).
== المعاملات ==
=== <code>index</code> ===
عدد صحيح يمثل فهرس العنصر المراد جلبه من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة.
==القيم المعادة==
==القيم المعادة==
يُعاد العنصر ذي الفهرس المعطى والموجود ضمن نطاق [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] المعطاة، أو القيمة العدمية <code>null</code> إن كان فهرس العنصر المعطى يقع خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]].
يُعاد العنصر ذي الفهرس المعطى والموجود ضمن نطاق [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] المعطاة، أو القيمة العدمية <code>null</code> إن كان فهرس العنصر المعطى يقع خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]].
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()elementAtOrNull</code> مع المصفوفات لجلب عنصر موجود===
تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()elementAtOrNull</code> لجلب العنصر الثالث والسابع من تلك المصفوفة:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()elementAtOrNull</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)
     println(array.elementAtOrNull(2)) // 3
     println(array.elementAtOrNull(2)) // 3
}
</syntaxhighlight>
===استخدام الدالة <code>()elementAtOrNull</code> مع المصفوفات لجلب عنصر غير موجود===
تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()elementAtOrNull</code> لجلب العنصر ذي الفهرس 6:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)
     println(array.elementAtOrNull(6)) // null
     println(array.elementAtOrNull(6)) // null
}
}
سطر 43: سطر 42:
* التابع <code>[[Kotlin/Array/get|Array.get()‎]]</code>: يعيد قيمة العنصر ذي الفهرس (index) المعطى الموجود في مصفوفة.
* التابع <code>[[Kotlin/Array/get|Array.get()‎]]</code>: يعيد قيمة العنصر ذي الفهرس (index) المعطى الموجود في مصفوفة.
==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/element-at-or-null.html الدالة elementAtOrNull()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>elementAtOrNull()‎</code> في Kotlin}}</noinclude>
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/element-at-or-null.html صفحة الدالة elementAtOrNull()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>elementAtOrNull()‎</code> في Kotlin}}</noinclude>
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 04:36، 3 سبتمبر 2018

تجلب الدالة elementAtOrNull()‎ عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود المصفوفة أو المجموعة، فستُعيد الدالة القيمة العدمية null.

البنية العامة

يمكن استدعاء الدالةelementAtOrNull()‎ مع المصفوفات:

inline fun <T> Array<out T>.elementAtOrNull(index: Int): T? 
inline fun ByteArray.elementAtOrNull(index: Int): Byte? 
inline fun ShortArray.elementAtOrNull(index: Int): Short?
inline fun IntArray.elementAtOrNull(index: Int): Int? 
inline fun LongArray.elementAtOrNull(index: Int): Long? 
inline fun FloatArray.elementAtOrNull(index: Int): Float? 
inline fun DoubleArray.elementAtOrNull(index: Int): Double? 
inline fun BooleanArray.elementAtOrNull(index: Int): Boolean? 
inline fun CharArray.elementAtOrNull(index: Int): Char?

ومع المجموعات:

fun <T> Iterable<T>.elementAtOrNull(index: Int): T?

ومع القوائم:

inline fun <T> List<T>.elementAtOrNull(index: Int): T?

وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة).

المعاملات

index

عدد صحيح يمثل فهرس العنصر المراد جلبه من المصفوفة أو المجموعة المعطاة.

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

يُعاد العنصر ذي الفهرس المعطى والموجود ضمن نطاق المصفوفة أو المجموعة المعطاة، أو القيمة العدمية null إن كان فهرس العنصر المعطى يقع خارج حدود المصفوفة أو المجموعة.

أمثلة

تعرِّف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()elementAtOrNull لجلب العنصر الثالث والسابع من تلك المصفوفة:

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)
    println(array.elementAtOrNull(2)) // 3
    println(array.elementAtOrNull(6)) // null
}

انظر أيضًا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/collections/elementAtOrNull&oldid=16309»