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

من موسوعة حسوب
التعديل اللاحق ←
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>elementAt()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>elementAt()‎</code> Kotlin/List|لا...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>elementAt()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>elementAt()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة<code>elementAt()‎</code> [[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى التي تحقق الشرط المنطقي <code>predicate</code> المُمرّر إلى الدالة.
تعيد الدالة<code>elementAt()‎</code> العنصر الموجود عند الفهرس (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].


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


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


[[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى التي تحقق الشرط المنطقي <code>predicate</code> المُمرّر إلى الدالة.
العنصر الموجود عند الفهرس (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>predicate</code> تحدد ما إذا كان العدد المُمرّر إليها أصغر من <code>3،</code> ثم تستخدم الدالة <code>()elementAt</code> للحصول على لائحة تضم جميع عناصر المصفوفة باستثناء العناصر الأولى التي تحقق الدالة المنطقية <code>()predicate</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>) {
val array = arrayOf(1,2,3,4,5,6)
val array = arrayOf(1,2,3,4,5,6)
val predicate: (Int) -> Boolean = { it < 3}
println(array.elementAt(3)) // 4
println(array.dropWhile(predicate)) // [3, 4, 5, 6]
}
}
</syntaxhighlight>
===استخدام الدالة <code>()elementAt</code> مع المصفوفات  ===
تعرف الشيفرة الآتية [[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>) {
val array = arrayOf(1,2,3,4,5,6)
println(array.elementAt(12))
}
</syntaxhighlight>
الخرج سيكون كما يلي:<syntaxhighlight lang="kotlin">
Exception in thread "main" java.lang.ArrayIndexOutOfBoundsException: 12
    at Simplest_versionKt.main(Simplest version.kt:3)
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا  ==
==انظر أيضًا  ==
* <code>[[Kotlin/collections/dropWhile|dropWhile()]]</code>‎: تعيد لائحة تحتوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى التي تحقق شرطا منطقيا محددًا
* <code>[[Kotlin/collections/elementAtOrElse|elementAtOrElse()]]</code>‎: تعيد العنصر الموجود عند الفهرس (index) المحدد  من  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها، وفي حال كان ذلك الفهرس خارج حدود [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] فستعيد ناتج تطبيق الدالة المُمررة على الفهرس.
 
* <code>[[Kotlin/collections/dropLast|dropLast()]]</code>‎: تعيد لائحة تحتوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأخيرة المحددة بالمعامل المُمرّر <code>n</code>.
* <code>[[Kotlin/collections/drop|drop()]]</code>‎: تعيد [[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى المحددة بالمعامل المُمرّر <code>n.</code>


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

مراجعة 19:17، 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)

انظر أيضًا

مصادر

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