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