الفرق بين المراجعتين لصفحة: «Kotlin/collections/getOrNull»
< Kotlin | collections
ط استبدال النص - 'Kotlin Methods' ب'Kotlin Function' |
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>getOrNull()</code> في Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>getOrNull()</code> في Kotlin}}</noinclude> | ||
تجلب الدالة <code>getOrNull()</code> عنصرًا | تجلب الدالة <code>getOrNull()</code> عنصرًا ذا فهرس مُحدَّد من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها أو تعيد القيمة <code>null</code> إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة. | ||
== البنية العامة == | == البنية العامة == | ||
يمكن استدعاء الدالة <code>getOrElse()</code> مع [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin"> | يمكن استدعاء الدالة <code>getOrElse()</code> مع [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin"> | ||
| سطر 16: | سطر 16: | ||
fun <T> List<T>.getOrNull(index: Int): T? | fun <T> List<T>.getOrNull(index: Int): T? | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | |||
=== <code>index</code> === | |||
عدد صحيح يمثل فهرس العنصر المراد جلبه. | |||
== القيم المعادة == | == القيم المعادة == | ||
يُعاد العنصر ذو الفهرس <code>index</code> من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها، أو القيمة <code>null</code> إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة. | يُعاد العنصر ذو الفهرس <code>index</code> من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها، أو القيمة <code>null</code> إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة. | ||
مراجعة 13:51، 3 سبتمبر 2018
تجلب الدالة getOrNull() عنصرًا ذا فهرس مُحدَّد من المصفوفة أو المجموعة التي استُدعيت معها أو تعيد القيمة null إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة.
البنية العامة
يمكن استدعاء الدالة getOrElse() مع المصفوفات:
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?
ويمكن استدعاؤها مع المجموعات أيضًا:
fun <T> List<T>.getOrNull(index: Int): T?
المعاملات
index
عدد صحيح يمثل فهرس العنصر المراد جلبه.
القيم المعادة
يُعاد العنصر ذو الفهرس index من المصفوفة أو المجموعة التي استُدعيت معها، أو القيمة null إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة.
أمثلة
استخدام الدالةgetOrNull() على مصفوفة: العنصر موجود
تعرِّف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثم تستخدم الدالة ()getOrNull لجلب قيمة العنصر ذي الفهرس 2:
fun main(args: Array<String>) {
val array = arrayOf(1, 2, 3, 4, 5, 6)
print(array.getOrNull(2)) // 3
}
استخدام الدالةgetOrNull() على مصفوفة: العنصر غير موجود
تعرِّف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()getOrNull لجلب قيمة العنصر ذي الفهرس 8:
fun main(args: Array<String>) {
val array = arrayOf(1, 2, 3, 4, 5, 6)
print(array.getOrNull(8)) // null
}
انظر أيضًا
- الدالة
getOrElse(): تجلب عنصرًا ذي فهرس مُحدَّد من المصفوفة أو المجموعة التي استُدعيت معها أو القيمة المقابلة لمفتاح محدَّد إن استدعيت مع خريطة. إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة أو كان المفتاح المعطى غير موجود في الخريطة، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة. - الدالة
filter(): ترشِّح عناصر المصفوفة أو المجموعة أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها. - الدالة
filterNotNull(): تعيد جميع عناصر المصفوفة أو المجموعة المعطاة باستثناء تلك ذات القيمةnull.