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

المراجعة الحالية بتاريخ 08:11، 8 سبتمبر 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) برمجيةٍ على كافّة عناصر المصفوفة.

مصادر

صفحة الدالة forEach()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>forEach()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>forEach()‎</code> في Kotlin}}</noinclude>
-تُراكِم الدالة<code>forEach()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار  على القيمة المُتراكمة الراهنة وعلى العنصر التالي من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
+تُنفّد الدالةُ <code>forEach()‎</code> الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|الخريطة]] التي استُدعيت معها.
 ==البنية العامة==
-يمكن استدعاء الدالة<code>foldRightIndexed()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
+يمكن استدعاء الدالة <code>forEach()‎</code> مع [[Kotlin/Array|المصفوفات]]، و<nowiki/>[[Kotlin/collections|المجموعات]]، والقواميس، والكائنات.<syntaxhighlight lang="kotlin">
-inline fun <T, R> Array<out T>.foldRightIndexed(
+inline fun <T> Array<out T>.forEach(action: (T) -> Unit)
-    initial: R,
+inline fun ByteArray.forEach(action: (Byte) -> Unit)
-    operation: (index: Int, T, acc: R) -> R
+inline fun ShortArray.forEach(action: (Short) -> Unit)
-): R
+inline fun IntArray.forEach(action: (Int) -> Unit)
-inline fun <R> ByteArray.foldRightIndexed(
+inline fun LongArray.forEach(action: (Long) -> Unit)
-    initial: R,
+inline fun FloatArray.forEach(action: (Float) -> Unit)
-    operation: (index: Int, Byte, acc: R) -> R
+inline fun DoubleArray.forEach(action: (Double) -> Unit)
-): R
+inline fun BooleanArray.forEach(action: (Boolean) -> Unit)
-inline fun <R> ShortArray.foldRightIndexed(
+inline fun CharArray.forEach(action: (Char) -> Unit)
-    initial: R,
+inline fun <T> Iterable<T>.forEach(action: (T) -> Unit)
-    operation: (index: Int, Short, acc: R) -> R
-): R
+inline fun <K, V> Map<out K, V>.forEach(
-inline fun <R> IntArray.foldRightIndexed(
+    action: (Entry<K, V>) -> Unit)
-    initial: R,
-    operation: (index: Int, Int, acc: R) -> R
+inline fun <T> Iterator<T>.forEach(operation: (T) -> Unit)
-): R
-inline fun <R> LongArray.foldRightIndexed(
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
-    initial: R,
-    operation: (index: Int, Long, acc: R) -> R
+== المعاملات ==
-): R
-inline fun <R> FloatArray.foldRightIndexed(
+=== <code>action</code> ===
-    initial: R,
+الدالة المراد تنفيذها مع كل كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|الخريطة]] المعطاة.
-    operation: (index: Int, Float, acc: R) -> R
-): R
-inline fun <R> DoubleArray.foldRightIndexed(
-    initial: R,
-    operation: (index: Int, Double, acc: R) -> R
-): R
-inline fun <R> BooleanArray.foldRightIndexed(
-    initial: R,
-    operation: (index: Int, Boolean, acc: R) -> R
-): R
-inline fun <R> CharArray.foldRightIndexed(
-    initial: R,
-    operation: (index: Int, Char, acc: R) -> R
-): R
-</syntaxhighlight>يمكن استدعاء غلدالة<code>foldRightIndexed()‎</code> على [[Kotlin/collections|المجموعات]].<syntaxhighlight lang="kotlin">
-inline fun <T, R> List<T>.foldRightIndexed(
-    initial: R,
-    operation: (index: Int, T, acc: R) -> R
-): R
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
-==القيم المٌعادة==
-ناتج تطبيق العملية المُمرّرة <code>operation</code> تراكميًا على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهارسها.
 ==أمثلة==
-===استخدام الدالة <code>()forEach</code> مع المصفوفات===
+تعرف الشيفرة الآتية <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> على <code>array</code> بتمرير القيمة الأوّلية <code>0</code> إضافة إلى عملية تُضيف القيمة المتراكمة الراهنة إلى حاصل ضرب عناصر <code>array</code> في فهارسها، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val array = arrayOf(1,2,3,4,5,6)
+    val iterator = (1..3).iterator()
+    // تخطي عنصر واحد فقط
+    if (iterator.hasNext()) {
+        iterator.next()
+    }
-val acc = array.foldRightIndexed(0) { acc , element , index -> acc + element*index }
+    // افعل شيئًا ما مع بقية العناصر
-print(acc) // 719
+    iterator.forEach {
+        println(" العنصر التالي هو $it")
+    }
 }
+// :سيُطبع الناتج
+// العنصر التالي هو 2
+// العنصر التالي هو 3
 </syntaxhighlight>
 ==انظر أيضًا==
-<code>[[Kotlin/collections/foldRight|foldRight()]]</code>‎:تُراكِم  القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. وتُعيد القيمة النهائية.
+* الدالة <code>[[Kotlin/collections/forEachIndexed|forEachIndexed()]]</code>‎: تُنفّد الدالةَ المُمرّرةَ إليها على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]]، أو [[Kotlin/collections|المجموعة]]، أو [[Kotlin/collections/Map|الخريطة]]، التي استُدعيت معها وعلى فهرس ذلك العنصر.
+* التابع <code>[[Kotlin/Array/iterator|Array.iterator()‎]]</code>: يعيد عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة.
-<code>[[Kotlin/collections/foldIndexed|foldIndexed()]]</code>‎: تُراكِم القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/fold-right-indexed.html الدالة  forEach()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/for-each.html صفحة الدالة forEach()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]