الفرق بين المراجعتين ل"Kotlin/collections/forEach"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (استبدال النص - 'Kotlin Functions' ب'Kotlin Function')
سطر 20: سطر 20:
  
 
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
 
</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">
 
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()forEach</code> لطباعة كل عنصر من عناصرها على مجرى الخرج القياسي بشكل منفرد:<syntaxhighlight lang="kotlin">

مراجعة 11:57، 3 سبتمبر 2018

تُنفّد الدالةُ forEach()‎ الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها.

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

يمكن استدعاء الدالة forEach()‎ مع المصفوفات، والمجموعات، والقواميس، والكائنات.

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)

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

المعاملات

action

الدالة المراد تنفيذها مع كل كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة المعطاة.

أمثلة

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

fun main(args: Array<String>) {
    val iterator = (1..3).iterator()
    // تخطي عنصر واحد فقط
    if (iterator.hasNext()) {
        iterator.next()
    }

    // افعل شيئًا ما مع بقية العناصر
    iterator.forEach {
        println(" العنصر التالي هو $it")
    }
}
// :سيُطبع الناتج
// العنصر التالي هو 2
// العنصر التالي هو 3

انظر أيضًا

  • الدالة forEachIndexed()‎: تُنفّد الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر المصفوفة، أو المجموعة، أو الخريطة، التي استُدعيت معها وعلى فهرس ذلك العنصر.
  • التابع Array.iterator()‎: يعيد عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.

مصادر