عرض مصدر Kotlin/collections/getOrNull

<noinclude>{{DISPLAYTITLE: الدالة <code>getOrNull()‎</code> في Kotlin}}</noinclude>
تجلب الدالة <code>getOrNull()‎</code> عنصرًا ذا فهرس مُحدَّد من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها أو تعيد القيمة <code>null</code> إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة.
== البنية العامة ==
يمكن استدعاء  الدالة <code>getOrElse()‎</code> مع [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
fun <T> Array<out T>.getOrNull(index: Int): T? 
fun ByteArray.getOrNull(index: Int): Byte? 
fun ShortArray.getOrNull(index: Int): Short? 
fun IntArray.getOrNull(index: Int): Int? 
fun LongArray.getOrNull(index: Int): Long? 
fun FloatArray.getOrNull(index: Int): Float? 
fun DoubleArray.getOrNull(index: Int): Double? 
fun BooleanArray.getOrNull(index: Int): Boolean? 
fun CharArray.getOrNull(index: Int): Char? 

</syntaxhighlight>ويمكن استدعاؤها مع [[Kotlin/collections|المجموعات]] أيضًا:<syntaxhighlight lang="kotlin">
fun <T> List<T>.getOrNull(index: Int): T? 
</syntaxhighlight>

== المعاملات ==

=== <code>index</code> ===
عدد صحيح يمثل فهرس العنصر المراد جلبه.

== القيم المعادة ==
يُعاد العنصر ذو الفهرس <code>index</code> من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها، أو القيمة <code>null</code> إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة.
== أمثلة ==

=== استخدام الدالة<code>getOrNull()‎</code> على مصفوفة: العنصر موجود ===
تعرِّف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()getOrNull</code> لجلب قيمة العنصر ذي الفهرس 2:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)

    print(array.getOrNull(2)) // 3
}
</syntaxhighlight>

=== استخدام الدالة<code>getOrNull()‎</code> على مصفوفة: العنصر غير موجود ===
تعرِّف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()getOrNull</code> لجلب قيمة العنصر ذي الفهرس 8:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)

    print(array.getOrNull(8)) // null
}
</syntaxhighlight>
== انظر أيضًا ==
* الدالة <code>[[Kotlin/collections/getOrElse|getOrElse()]]‎</code>: تجلب عنصرًا ذي فهرس مُحدَّد من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها أو القيمة المقابلة لمفتاح محدَّد إن استدعيت مع خريطة. إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة أو كان المفتاح المعطى غير موجود في الخريطة، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة.
* الدالة <nowiki/>[[Kotlin/collections/filter|<code>filter()</code>‎]]: ترشِّح عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها.
* الدالة <code>[[Kotlin/collections/filterNotNull|filterNotNull()‎]]</code>: تعيد جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة باستثناء تلك ذات القيمة <code>null</code>.

== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/get-or-null.html صفحة الدالة getOrNull()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]