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

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

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

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

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

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)

في حال استدعاء الدالةforEach()‎ على القواميس فإنّها تنفّذ الدالة المُمرّرة action على كل عناصرها.

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

في حال استدعاء الدالةforEach()‎ على الكائنات من الصنف iterator فإنّها تنفّذ الدالة المُمرّرة action على كل عناصرها.

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

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

أمثلة

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

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

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

array.forEach { print("$it ") } // 1 2 3 4 5 6 
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>forEach()‎</code> في لغة Kotlin}}</noinclude>
-تُراكِم الدالة<code>forEach()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار  على القيمة المُتراكمة الراهنة وعلى العنصر التالي من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
+تُنفّد الدالةُ<code>forEach()‎</code> الدالةَ المُمرّرةَ <code>action</code> على كل عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/collections/Map|القاموس]] الذي استُدعيت عبره.
 ==البنية العامة==
-يمكن استدعاء الدالة<code>foldRightIndexed()‎</code> على [[Kotlin/Array|المصفوفات]].<syntaxhighlight lang="kotlin">
+في حال استدعاء الدالة<code>forEach()‎</code> على [[Kotlin/Array|المصفوفات]] أو [[Kotlin/collections|المجموعات]] فإنّها تنفّذ الدالة المُمرّرة <code>action</code> على كل عناصرها.<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
+</syntaxhighlight>في حال استدعاء الدالة<code>forEach()‎</code> على [[Kotlin/collections/Map|القواميس]] فإنّها تنفّذ الدالة المُمرّرة <code>action</code> على كل عناصرها.<syntaxhighlight lang="kotlin">
-inline fun <R> IntArray.foldRightIndexed(
+inline fun <K, V> Map<out K, V>.forEach(
-    initial: R,
+     action: (Entry<K, V>) -> Unit)
-    operation: (index: Int, Int, acc: R) -> R
+</syntaxhighlight>في حال استدعاء الدالة<code>forEach()‎</code> على الكائنات من الصنف <code>[[Kotlin/iterator|iterator]]</code>  فإنّها تنفّذ الدالة المُمرّرة <code>action</code> على كل عناصرها.<syntaxhighlight lang="kotlin">
-): R
+inline fun <T> Iterator<T>.forEach(operation: (T) -> Unit)
-inline fun <R> LongArray.foldRightIndexed(
-    initial: R,
-    operation: (index: Int, Long, acc: R) -> R
-): R
-inline fun <R> FloatArray.foldRightIndexed(
-    initial: R,
-    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> على <code>array</code> بتمرير القيمة الأوّلية <code>0</code> إضافة إلى عملية تُضيف القيمة المتراكمة الراهنة إلى حاصل ضرب عناصر <code>array</code> في فهارسها، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()forEach</code> على <code>array</code> بتمرير دالة كمُعامل، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
 val array = arrayOf(1,2,3,4,5,6)
-val acc = array.foldRightIndexed(0) { acc , element , index -> acc + element*index }
+array.forEach { print("$it ") } // 1 2 3 4 5 6
-print(acc) // 719
 }
 </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/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]]