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

من موسوعة حسوب
التعديل اللاحق ←
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>forEachIndexed()‎</code> في لغة Kotlin}}</noinclude> تُنفّد الدالةُ<code>forEachIndexed()‎</code> ا...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>forEachIndexed()‎</code> في لغة Kotlin}}</noinclude>
تُنفّد الدالةُ<code>forEachIndexed()‎</code> الدالةَ المُمرّرةَ <code>action</code> على كل عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] الذي استُدعيت عبره وعلى فهارسها (indices).
تُنفّد الدالةُ<code>forEachIndexed()‎</code> الدالةَ المُمرّرةَ <code>action</code> على كل عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] الذي استُدعيت عبره.  
==البنية العامة==
==البنية العامة==
في حال استدعاء الدالة<code>forEachIndexed()‎</code> على [[Kotlin/Array|المصفوفات]] أو [[Kotlin/collections|المجموعات]] فإنّها تنفّذ الدالة المُمرّرة <code>action</code> على كل عناصرها.<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.forEach(action: (T) -> Unit)  
inline fun <T> Array<out T>.forEachIndexed(
inline fun ByteArray.forEach(action: (Byte) -> Unit)  
    action: (index: Int, T) -> Unit)  
inline fun ShortArray.forEach(action: (Short) -> Unit)  
inline fun ByteArray.forEachIndexed(
inline fun IntArray.forEach(action: (Int) -> Unit)  
    action: (index: Int, Byte) -> Unit)
inline fun LongArray.forEach(action: (Long) -> Unit)  
inline fun ShortArray.forEachIndexed(
inline fun FloatArray.forEach(action: (Float) -> Unit)  
    action: (index: Int, Short) -> Unit)  
inline fun DoubleArray.forEach(action: (Double) -> Unit)
inline fun IntArray.forEachIndexed(
inline fun BooleanArray.forEach(action: (Boolean) -> Unit)  
    action: (index: Int, Int) -> Unit)  
inline fun CharArray.forEach(action: (Char) -> Unit)  
inline fun LongArray.forEachIndexed(
inline fun <T> Iterable<T>.forEach(action: (T) -> Unit)  
    action: (index: Int, Long) -> Unit)  
inline fun FloatArray.forEachIndexed(
    action: (index: Int, Float) -> Unit)  
inline fun DoubleArray.forEachIndexed(
    action: (index: Int, Double) -> Unit) (
inline fun BooleanArray.forEachIndexed(
    action: (index: Int, Boolean) -> Unit) (source)
inline fun CharArray.forEachIndexed(
    action: (index: Int, Char) -> Unit)  
inline fun <T> Iterable<T>.forEachIndexed(
    action: (index: Int, T) -> Unit)  


</syntaxhighlight>في حال استدعاء الدالة<code>forEachIndexed()‎</code> على [[Kotlin/collections/Map|القواميس]] فإنّها تنفّذ الدالة المُمرّرة <code>action</code> على كل عناصرها.<syntaxhighlight lang="kotlin">
inline fun <K, V> Map<out K, V>.forEach(
    action: (Entry<K, V>) -> Unit)
</syntaxhighlight>في حال استدعاء الدالة<code>forEachIndexed()‎</code> على الكائنات من الصنف <code>[[Kotlin/iterator|iterator]]</code>  فإنّها تنفّذ الدالة المُمرّرة <code>action</code> على كل عناصرها.<syntaxhighlight lang="kotlin">
inline fun <T> Iterator<T>.forEach(operation: (T) -> Unit)
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()forEachIndexed</code> مع المصفوفات===
===استخدام الدالة <code>()forEachIndexed</code> مع المصفوفات===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()forEachIndexed</code> على <code>array</code> بتمرير دالة كمُعامل، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()forEachIndexed</code> على <code>array</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)


array.forEach { print("$it ") } // 1 2 3 4 5 6  
array.forEachIndexed {index, element  -> print("$element:$index ") } // 1:0 2:1 3:2 4:3 5:4 6:5 
}
}
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا==
==انظر أيضًا==
<code>[[Kotlin/collections/forEachIndexed|forEachIndexed()]]</code>‎: تُنفّد الدالةَ المُمرّرةَ على كل عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] الذي استُدعيت عبره.
<code>[[Kotlin/collections/forEach|forEach()]]</code>‎: تُنفّد الدالةُ<code>forEach()‎</code> الدالةَ المُمرّرةَ <code>action</code> على كل عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو <nowiki/>[[Kotlin/collections/Map|القاموس]] الذي استُدعيت عبره.
 
==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/for-each.html الدالة  forEachIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/for-each-indexed.html الدالة  forEachIndexed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>forEachIndexed()‎</code> في لغة Kotlin}}</noinclude>
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Functions]]

مراجعة 18:31، 17 مايو 2018

تُنفّد الدالةُforEachIndexed()‎ الدالةَ المُمرّرةَ action على كل عناصر المصفوفة أو المجموعة أو القاموس الذي استُدعيت عبره وعلى فهارسها (indices).

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

inline fun <T> Array<out T>.forEachIndexed(
    action: (index: Int, T) -> Unit) 
inline fun ByteArray.forEachIndexed(
    action: (index: Int, Byte) -> Unit)
inline fun ShortArray.forEachIndexed(
    action: (index: Int, Short) -> Unit) 
inline fun IntArray.forEachIndexed(
    action: (index: Int, Int) -> Unit) 
inline fun LongArray.forEachIndexed(
    action: (index: Int, Long) -> Unit) 
inline fun FloatArray.forEachIndexed(
    action: (index: Int, Float) -> Unit) 
inline fun DoubleArray.forEachIndexed(
    action: (index: Int, Double) -> Unit) (
inline fun BooleanArray.forEachIndexed(
    action: (index: Int, Boolean) -> Unit) (source)
inline fun CharArray.forEachIndexed(
    action: (index: Int, Char) -> Unit) 
inline fun <T> Iterable<T>.forEachIndexed(
    action: (index: Int, T) -> Unit)

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

أمثلة

استخدام الدالة ()forEachIndexed مع المصفوفات

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

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

array.forEachIndexed {index, element  -> print("$element:$index ") } // 1:0 2:1 3:2 4:3 5:4 6:5  
}

انظر أيضًا

forEach()‎: تُنفّد الدالةُforEach()‎ الدالةَ المُمرّرةَ action على كل عناصر المصفوفة أو المجموعة أو القاموس الذي استُدعيت عبره.

مصادر

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