الفرق بين المراجعتين لصفحة: «Kotlin/collections/elementAt»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 25: | سطر 25: | ||
العنصر الموجود عند الفهرس (index) المحدد من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] فستُطلق [[Kotlin/exceptions|استثناءً]] [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-index-out-of-bounds-exception/index.html IndexOutOfBoundsException]. | العنصر الموجود عند الفهرس (index) المحدد من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] فستُطلق [[Kotlin/exceptions|استثناءً]] [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-index-out-of-bounds-exception/index.html IndexOutOfBoundsException]. | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()elementAt</code> مع المصفوفات === | ===استخدام الدالة <code>()elementAt</code> مع المصفوفات: الحالة الأولى === | ||
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()elementAt</code> للحصول على العنصر الموجود عند الفهرس <code>3</code> ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()elementAt</code> للحصول على العنصر الموجود عند الفهرس <code>3</code> ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| سطر 32: | سطر 32: | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===استخدام الدالة <code>()elementAt</code> مع المصفوفات === | ===استخدام الدالة <code>()elementAt</code> مع المصفوفات: الحالة الثانية === | ||
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()elementAt</code> للحصول على العنصر الموجود عند الفهرس <code>12،</code> ولما كان هذا الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] فستُطلق الدالة [[Kotlin/exceptions|استثناءً]]:<syntaxhighlight lang="kotlin"> | تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()elementAt</code> للحصول على العنصر الموجود عند الفهرس <code>12،</code> ولما كان هذا الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] فستُطلق الدالة [[Kotlin/exceptions|استثناءً]]:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
مراجعة 19:19، 13 مايو 2018
تعيد الدالةelementAt() العنصر الموجود عند الفهرس (index) المحدد من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود المصفوفة أو المجموعة فستُطلق استثناءً IndexOutOfBoundsException.
البنية العامة
يمكن استدعاء الدالةelementAt() على المصفوفات.
inline fun <T> Array<out T>.elementAt(index: Int): T
inline fun ByteArray.elementAt(index: Int): Byte
inline fun ShortArray.elementAt(index: Int): Short
inline fun IntArray.elementAt(index: Int): Int
inline fun LongArray.elementAt(index: Int): Long
inline fun FloatArray.elementAt(index: Int): Float
inline fun DoubleArray.elementAt(index: Int): Double
inline fun BooleanArray.elementAt(index: Int): Boolean
inline fun CharArray.elementAt(index: Int): Char
يمكن استدعاء الدالةelementAt() على المجموعات.
fun <T> Iterable<T>.elementAt(index: Int): T
يمكن استدعاء الدالةelementAt() على اللوائح.
inline fun <T> List<T>.elementAt(index: Int): T
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
العنصر الموجود عند الفهرس (index) المحدد من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود المصفوفة أو المجموعة فستُطلق استثناءً IndexOutOfBoundsException.
أمثلة
استخدام الدالة ()elementAt مع المصفوفات: الحالة الأولى
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()elementAt للحصول على العنصر الموجود عند الفهرس 3 ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
println(array.elementAt(3)) // 4
}
استخدام الدالة ()elementAt مع المصفوفات: الحالة الثانية
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()elementAt للحصول على العنصر الموجود عند الفهرس 12، ولما كان هذا الفهرس خارج حدود المصفوفة فستُطلق الدالة استثناءً:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
println(array.elementAt(12))
}
الخرج سيكون كما يلي:
Exception in thread "main" java.lang.ArrayIndexOutOfBoundsException: 12
at Simplest_versionKt.main(Simplest version.kt:3)
انظر أيضًا
elementAtOrElse(): تعيد العنصر الموجود عند الفهرس (index) المحدد من المصفوفة أو المجموعة التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود المصفوفة أو المجموعة فستعيد ناتج تطبيق الدالة المُمررة على الفهرس.