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

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
لا ملخص تعديل
طلا ملخص تعديل
 
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة getOrNull()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>getOrNull()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>getOrNull()‎</code> قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. ، أو <code>null</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">
fun <T> Array<out T>.getOrNull(index: Int): T?  
fun <T> Array<out T>.getOrNull(index: Int): T?  
fun ByteArray.getOrNull(index: Int): Byte?  
fun ByteArray.getOrNull(index: Int): Byte?  
سطر 13: سطر 13:
fun CharArray.getOrNull(index: Int): Char?  
fun CharArray.getOrNull(index: Int): Char?  


</syntaxhighlight>يمكن استدعاء  الدالة <code>getOrElse()‎</code> عبر [[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
</syntaxhighlight>ويمكن استدعاؤها مع [[Kotlin/collections|المجموعات]] أيضًا:<syntaxhighlight lang="kotlin">
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> إن كان الفهرس المعطى يقع خارج حدود المصفوفة أو المجموعة.
== أمثلة ==
== أمثلة ==


=== استخدام الدالة<code>getOrNull()‎</code> على مصفوفة: الحالة الأولى ===
=== استخدام الدالة<code>getOrNull()‎</code> على مصفوفة: العنصر موجود ===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()getOrNull</code>  للحصول على قيمة العنصر عند الفهرس <code>2</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()getOrNull</code> لجلب قيمة العنصر ذي الفهرس 2:<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)


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


=== استخدام الدالة<code>getOrNull()‎</code> على مصفوفة: الحالة الثانية ===
=== استخدام الدالة<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">
تعرِّف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()getOrNull</code> لجلب قيمة العنصر ذي الفهرس 8:<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)


     print(array.getOrNull(8)) // null
     print(array.getOrNull(8)) // null
سطر 38: سطر 44:
</syntaxhighlight>
</syntaxhighlight>
== انظر أيضًا ==
== انظر أيضًا ==
* <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> موجودًا.
* الدالة <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.]
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/get-or-null.html صفحة الدالة getOrNull()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 08:11، 8 سبتمبر 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.

مصادر

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