عرض مصدر Kotlin/collections/forEach

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

inline fun <K, V> Map<out K, V>.forEach(
    action: (Entry<K, V>) -> Unit) 

inline fun <T> Iterator<T>.forEach(operation: (T) -> Unit)

</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).

== المعاملات ==

=== <code>action</code> ===
الدالة المراد تنفيذها مع كل كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|الخريطة]] المعطاة.

==أمثلة==
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()forEach</code> لطباعة كل عنصر من عناصرها على مجرى الخرج القياسي بشكل منفرد:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val iterator = (1..3).iterator()
    // تخطي عنصر واحد فقط
    if (iterator.hasNext()) {
        iterator.next()
    }

    // افعل شيئًا ما مع بقية العناصر
    iterator.forEach {
        println(" العنصر التالي هو $it")
    }
}
// :سيُطبع الناتج
// العنصر التالي هو 2
// العنصر التالي هو 3
</syntaxhighlight>
==انظر أيضًا==
* الدالة <code>[[Kotlin/collections/forEachIndexed|forEachIndexed()]]</code>‎: تُنفّد الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]]، أو [[Kotlin/collections|المجموعة]]، أو [[Kotlin/collections/Map|الخريطة]]، التي استُدعيت معها وعلى فهرس ذلك العنصر.
* التابع <code>[[Kotlin/Array/iterator|Array.iterator()‎]]</code>: يعيد عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.

==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/for-each.html صفحة الدالة forEach()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]