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

مراجعة 12:45، 4 يوليو 2018

تجلب الدالة elementAtOrElse()‎ عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود المصفوفة أو المجموعة، فستُعيد الدالة ناتج استدعاء دالة معينة.

البنية العامة

يمكن استدعاء الدالة elementAtOrElse()‎ مع المصفوفات:

inline fun <T> Array<out T>.elementAtOrElse(
    index: Int, 
    defaultValue: (Int) -> T
): T 
inline fun ByteArray.elementAtOrElse(
    index: Int, 
    defaultValue: (Int) -> Byte
): Byte 
inline fun ShortArray.elementAtOrElse(
    index: Int, 
    defaultValue: (Int) -> Short
): Short 
inline fun IntArray.elementAtOrElse(
    index: Int, 
    defaultValue: (Int) -> Int
): 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

ومع المجموعات:

fun <T> Iterable<T>.elementAtOrElse(
    index: Int, 
    defaultValue: (Int) -> T
): T

ومع القوائم:

inline fun <T> List<T>.elementAtOrElse(
    index: Int, 
    defaultValue: (Int) -> T
): T

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

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

يُعاد العنصر ذي الفهرس المعطى والموجود ضمن نطاق المصفوفة أو المجموعة المعطاة، أو ناتج استدعاء الدالة defaultValue()‎ إن كان فهرس العنصر المعطى يقع خارج حدود المصفوفة أو المجموعة.

أمثلة

استخدام الدالة `()elementAtOrElse` مع المصفوفات لجلب عنصر موجود

تعرِّف الشيفرة الآتية مصفوفة باسم arrayباستخدام الدالة ()arrayOf ثمَّ تعرِّف دالة باسم default لاستعمالها مع ()elementAtOrElse إن كان العنصر المراد جلبه يقع خارج مجال المصفوفة:

fun main(args: Array<String>) {
    val array = arrayOf(1,2,3,4,5,6)
    val default: (Int) -> Int = { it * 10}

    println(array.elementAtOrElse(2,default)) // 3
}

استخدام الدالة `()elementAtOrElse` مع المصفوفات لجلب عنصر غير موجود

تعرِّف الشيفرة الآتية مصفوفة باسم arrayباستخدام الدالة ()arrayOf ثمَّ تعرِّف دالة باسم default لاستعمالها مع ()elementAtOrElse إن كان العنصر المراد جلبه يقع خارج مجال المصفوفة:

fun main(args: Array<String>) {
    val array = arrayOf(1,2,3,4,5,6)
    val default: (Int) -> Int = { it * 10}

    println(array.elementAtOrElse(12,default)) // 120
}

انظر أيضًا

الدالة elementAt()‎: تجلب عنصرًا ذي فهرس معيَّن من المصفوفة أو المجموعة التي استُدعيت معها.
الدالة elementAtOrNull()‎: تجلب العنصر ذي الفهرس المعطى والموجود ضمن نطاق المصفوفة أو المجموعة المعطاة، أو القيمة العدمية null إن كان فهرس العنصر المعطى يقع خارج حدود المصفوفة أو المجموعة.
الدالة dropLast()‎: تعيد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء أول n عنصر.
الدالة distinctBy()‎: تعيد قائمة تحتوي على العناصر الموجودة في المصفوفة أو المجموعة التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق دالة معينة عليها فقط.
التابع Array.get()‎: يعيد قيمة العنصر ذي الفهرس (index) المعطى الموجود في مصفوفة.

مصادر

الدالة elementAtOrElse()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>elementAtOrElse()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة<code>elementAtOrElse()‎</code> العنصر الموجود عند الفهرس (index) المحدد  من  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] فستُعيد ناتج تطبيق الدالة المُمرّرة <code>defaultValue()‎</code> على الفهرس.
+تجلب الدالة <code>elementAtOrElse()‎</code> عنصرًا ذي فهرس معيَّن من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]]، فستُعيد الدالة ناتج استدعاء دالة معينة.
+==البنية العامة==
-== البنية العامة ==
+يمكن استدعاء الدالة <code>elementAtOrElse()‎</code> مع [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
-يمكن استدعاء الدالة<code>elementAtOrElse()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
 inline fun <T> Array<out T>.elementAtOrElse(
      index: Int,
@@ سطر 40: / سطر 39: @@
      defaultValue: (Int) -> Char
 ): Char
-</syntaxhighlight>يمكن استدعاء الدالة<code>elementAtOrElse()‎</code> على [[Kotlin/Array|المجموعات]].<syntaxhighlight lang="kotlin">
+</syntaxhighlight>ومع [[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
 fun <T> Iterable<T>.elementAtOrElse(
      index: Int,
      defaultValue: (Int) -> T
 ): T
-</syntaxhighlight>يمكن استدعاء الدالة<code>elementAtOrElse()‎</code> على [[Kotlin/List|اللوائح]].<syntaxhighlight lang="kotlin">
+</syntaxhighlight>ومع [[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|توثيق الدوال المباشرة]]).
+==القيم المعادة==
-== القيم المعادة ==
+يُعاد العنصر ذي الفهرس المعطى والموجود ضمن نطاق [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] المعطاة، أو ناتج استدعاء الدالة <code>defaultValue()‎</code> إن كان فهرس العنصر المعطى يقع خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]].
-العنصر الموجود عند الفهرس (index) المحدد  من  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]]  فستُعيد ناتج تطبيق الدالة المُمرّرة <code>defaultValue()‎</code> على الفهرس.
 ==أمثلة==
-===استخدام الدالة <code>()elementAt</code> مع المصفوفات: الحالة الأولى  ===
+===استخدام الدالة <code>()elementAtOrElse</code> مع المصفوفات لجلب عنصر موجود===
-تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تعرف دالة باسم  <code>default،</code> ثم تستخدم الدالة <code>()elementAtOrElse</code> للحصول على العنصر الموجود عند الفهرس <code>2</code> ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>باستخدام الدالة <code>()arrayOf</code> ثمَّ تعرِّف دالة باسم <code>default</code> لاستعمالها مع <code>()elementAtOrElse</code> إن كان العنصر المراد جلبه يقع خارج مجال المصفوفة:<syntaxhighlight lang="kotlin">
 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}
+    val default: (Int) -> Int = { it * 10}
-println(array.elementAtOrElse(2,default)) // 3
+    println(array.elementAtOrElse(2,default)) // 3
 }
 </syntaxhighlight>
-===استخدام الدالة <code>()elementAtOrElse</code> مع المصفوفات: الحالة الثانية  ===
+===استخدام الدالة <code>()elementAtOrElse</code> مع المصفوفات لجلب عنصر غير موجود===
-تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تعرف دالة باسم  <code>()default،</code>ثم تستخدم الدالة <code>()elementAtOrElse</code> للحصول على العنصر الموجود عند الفهرس <code>12،</code> ولما كان هذا الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] فستُعيد الدالة ناتج تطبيق الدالة <code>()default</code> على الفهرس المُمرّر (<code>12</code>) ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>باستخدام الدالة <code>()arrayOf</code> ثمَّ تعرِّف دالة باسم <code>default</code> لاستعمالها مع <code>()elementAtOrElse</code> إن كان العنصر المراد جلبه يقع خارج مجال المصفوفة:<syntaxhighlight lang="kotlin">
 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}
+    val default: (Int) -> Int = { it * 10}
-println(array.elementAtOrElse(12,default)) // 120
+    println(array.elementAtOrElse(12,default)) // 120
 }
 </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>‎: تجلب عنصرًا ذي فهرس معيَّن من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت معها.
-* <code>[[Kotlin/collections/elementAtOrNull|elementAtOrNull()]]</code>‎: تعيد العنصر الموجود عند الفهرس (index) المحدد  من  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]]  فستُعيد القيمة المعدومة <code>null</code>.
+*الدالة <code>[[Kotlin/collections/elementAtOrNull|elementAtOrNull()]]</code>‎: تجلب العنصر ذي الفهرس المعطى والموجود ضمن نطاق [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] المعطاة، أو القيمة العدمية <code>null</code> إن كان فهرس العنصر المعطى يقع خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]].
+* الدالة <code>[[Kotlin/collections/dropLast|dropLast()]]</code>‎: تعيد قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء أول <code>n</code> عنصر.
+* الدالة <code>[[Kotlin/collections/distinctBy|distinctBy()‎]]</code>: تعيد قائمة تحتوي على العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق دالة معينة عليها فقط.
+* التابع <code>[[Kotlin/Array/get|Array.get()‎]]</code>: يعيد قيمة العنصر ذي الفهرس (index) المعطى الموجود في مصفوفة.
 ==مصادر==
 *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/element-at-or-else.html الدالة  elementAtOrElse()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]