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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>elementAtOrNull()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>elementAtOrNull()‎</code> الع...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>elementAtOrNull()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>elementAtOrNull()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة<code>elementAtOrNull()‎</code> العنصر الموجود عند الفهرس (index) المحدد  من  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] فستُعيد ناتج تطبيق الدالة المُمرّرة <code>defaultValue()‎</code> على الفهرس.
تعيد الدالة<code>elementAtOrNull()‎</code> العنصر الموجود عند الفهرس (index) المحدد  من  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] فستُعيد القيمة المعدومة <code>null</code>.


== البنية العامة ==
== البنية العامة ==
يمكن استدعاء الدالة<code>elementAtOrElse()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
يمكن استدعاء الدالة<code>elementAtOrNull()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.elementAtOrElse(
inline fun <T> Array<out T>.elementAtOrNull(index: Int): T?
    index: Int,
inline fun ByteArray.elementAtOrNull(index: Int): Byte?
    defaultValue: (Int) -> T
inline fun ShortArray.elementAtOrNull(index: Int): Short?
): T  
inline fun IntArray.elementAtOrNull(index: Int): Int?
inline fun ByteArray.elementAtOrElse(
inline fun LongArray.elementAtOrNull(index: Int): Long?
    index: Int,
inline fun FloatArray.elementAtOrNull(index: Int): Float?
    defaultValue: (Int) -> Byte
inline fun DoubleArray.elementAtOrNull(index: Int): Double?
): Byte  
inline fun BooleanArray.elementAtOrNull(index: Int): Boolean?
inline fun ShortArray.elementAtOrElse(
inline fun CharArray.elementAtOrNull(index: Int): Char?
    index: Int,
 
    defaultValue: (Int) -> Short
</syntaxhighlight>يمكن استدعاء الدالة<code>elementAtOrNull()‎</code> على [[Kotlin/Array|المجموعات]].<syntaxhighlight lang="kotlin">
): Short  
fun <T> Iterable<T>.elementAtOrNull(index: Int): T?
inline fun IntArray.elementAtOrElse(
 
    index: Int,
</syntaxhighlight>يمكن استدعاء الدالة<code>elementAtOrNull()‎</code> على [[Kotlin/List|اللوائح]].<syntaxhighlight lang="kotlin">
    defaultValue: (Int) -> Int
inline fun <T> List<T>.elementAtOrNull(index: Int): T?
): Int  
 
inline fun LongArray.elementAtOrElse(
    index: Int,
    defaultValue: (Int) -> Long
): Long  
inline fun FloatArray.elementAtOrElse(
    index: Int,
    defaultValue: (Int) -> Float
): Float  
inline fun DoubleArray.elementAtOrElse(
    index: Int,
    defaultValue: (Int) -> Double
): Double  
inline fun BooleanArray.elementAtOrElse(
    index: Int,
    defaultValue: (Int) -> Boolean
): Boolean  
inline fun CharArray.elementAtOrElse(
    index: Int,
    defaultValue: (Int) -> Char
): Char
</syntaxhighlight>يمكن استدعاء الدالة<code>elementAtOrElse()‎</code> على [[Kotlin/Array|المجموعات]].<syntaxhighlight lang="kotlin">
fun <T> Iterable<T>.elementAtOrElse(
    index: Int,
    defaultValue: (Int) -> T
): T
</syntaxhighlight>يمكن استدعاء الدالة<code>elementAtOrElse()‎</code> على [[Kotlin/List|اللوائح]].<syntaxhighlight lang="kotlin">
inline fun <T> List<T>.elementAtOrElse(
    index: Int,
    defaultValue: (Int) -> T
): T
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].


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


العنصر الموجود عند الفهرس (index) المحدد  من  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] فستُعيد ناتج تطبيق الدالة المُمرّرة <code>defaultValue()‎</code> على الفهرس.
العنصر الموجود عند الفهرس (index) المحدد  من  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] فستُعيد القيمة المعدومة <code>null</code>.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()elementAtOrNull</code> مع المصفوفات: الحالة الأولى  ===
===استخدام الدالة <code>()elementAtOrNull</code> مع المصفوفات: الحالة الأولى  ===
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تعرف دالة باسم  <code>default،</code> ثم تستخدم الدالة <code>()elementAt</code> للحصول على العنصر الموجود عند الفهرس <code>2</code> ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()elementAtOrNull</code> للحصول على العنصر الموجود عند الفهرس <code>2</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)
val default: (Int) -> Int = { it * 10}
println(array.elementAtOrNull(2)) // 3
 
println(array.elementAtOrElse(2,default)) // 3
}
}
</syntaxhighlight>
</syntaxhighlight>
===استخدام الدالة <code>()elementAtOrNull</code> مع المصفوفات: الحالة الثانية  ===
===استخدام الدالة <code>()elementAtOrNull</code> مع المصفوفات: الحالة الثانية  ===
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تعرف دالة باسم  <code>()default،</code>ثم تستخدم الدالة <code>()elementAt</code> للحصول على العنصر الموجود عند الفهرس <code>12،</code> ولما كان هذا الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] فستُعيد الدالة ناتج تطبيق الدالة <code>()default</code> على الفهرس المُمرّر (<code>12</code>) ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()elementAtOrNull</code> للحصول على العنصر الموجود عند الفهرس <code>12،</code> ولما كان هذا الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] فستُعيد الدالة (<code>12</code>) القيمة المعدومة <code>null</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)
val default: (Int) -> Int = { it * 10}
println(array.elementAtOrNull(12)) // null
println(array.elementAtOrElse(12,default)) // 120
}
}
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا  ==
==انظر أيضًا  ==
* <code>[[Kotlin/collections/elementAt|elementAt()]]</code>‎: تعيد العنصر الموجود عند الفهرس (index) المحدد  من  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]]  فستُطلق <nowiki/>[[Kotlin/exceptions|استثناءً]]  [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-index-out-of-bounds-exception/index.html IndexOutOfBoundsException].
* <code>[[Kotlin/collections/elementAt|elementAt()]]</code>‎: تعيد العنصر الموجود عند الفهرس (index) المحدد  من  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]]  فستُطلق <nowiki/>[[Kotlin/exceptions|استثناءً]]  [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-index-out-of-bounds-exception/index.html IndexOutOfBoundsException].
* <code>[[Kotlin/collections/elementAtOrNull|elementAtOrNull()]]</code>‎: تعيد العنصر الموجود عند الفهرس (index) المحدد من  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] فستُعيد القيمة المعدومة <code>null</code>.
* <code>[[Kotlin/collections/elementAtOrElse|elementAtOrElse()]]</code>‎: تعيد العنصر الموجود عند الفهرس (index) المحدد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] فستُعيد ناتج تطبيق الدالة المُمرّرة <code>defaultValue()‎</code> على الفهرس.


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

مراجعة 19:30، 13 مايو 2018

تعيد الدالةelementAtOrNull()‎ العنصر الموجود عند الفهرس (index) المحدد من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود المصفوفة أو المجموعة فستُعيد القيمة المعدومة 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?

يمكن استدعاء الدالةelementAtOrNull()‎ على المجموعات.

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

يمكن استدعاء الدالةelementAtOrNull()‎ على اللوائح.

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

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

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

العنصر الموجود عند الفهرس (index) المحدد من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود المصفوفة أو المجموعة فستُعيد القيمة المعدومة null.

أمثلة

استخدام الدالة ()elementAtOrNull مع المصفوفات: الحالة الأولى

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()elementAtOrNull للحصول على العنصر الموجود عند الفهرس 2 ثم تطبع الناتج:

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

استخدام الدالة ()elementAtOrNull مع المصفوفات: الحالة الثانية

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()elementAtOrNull للحصول على العنصر الموجود عند الفهرس 12، ولما كان هذا الفهرس خارج حدود المصفوفة فستُعيد الدالة (12) القيمة المعدومة null ثم تطبع الناتج:

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

انظر أيضًا

مصادر