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

المراجعة الحالية بتاريخ 11:53، 3 سبتمبر 2018

تُنفّد الدالةُ forEach()‎ الدالةَ المُمرّرةَ إليها على كل محرف من محارف السلسلة التي استُدعيت معها.

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

inline fun CharSequence.forEach(
    action: (Char) -> Unit)

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

المعاملات

`action`

الدالة المراد تنفيذها مع كل محرف من محارف السلسلة المعطاة.

أمثلة

مثالٌ على استعمال الدالة ()forEach:

fun main(args: Array<String>) {
    val str = "Hsoub wiki"

    str.forEach {print("$it:")} // H:s:o:u:b: :w:i:k:i:
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.forEach()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.forEach()‎</code> في Kotlin}}</noinclude>
-تنفّذ الدالةُ<code>forEach()‎</code> الدالةَ المُمرّرة <code>action</code> على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها.
+تُنفّد الدالةُ <code>forEach()‎</code> الدالةَ المُمرّرةَ إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
 inline fun CharSequence.forEach(
      action: (Char) -> Unit)
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>action</code> ===
+الدالة المراد تنفيذها مع كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة.
 ==أمثلة==
-===استخدام الدالة <code>()forEach</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()forEach</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()forEach</code> عبرها مع تمرير دالة كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val str = "Hsoub wiki"
-     str.forEach {print(it)} // Hsoub wiki
+     str.forEach {print("$it:")} // H:s:o:u:b: :w:i:k:i:
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/forEachIndexed|forEachIndexed()]]‎</code>: تنفّذ الدالةُ<code>forEachIndexed()‎</code> الدالةَ المُمرّرة <code>action</code> على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها وعلى فهارسها.
+* الدالة <code>[[Kotlin/kotlin.text/forEachIndexed|forEachIndexed()]]‎</code>: تُنفّد الدالةَ المُمرّرةَ إليها على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها وعلى فهرس ذلك المحرف.
+* الدالة <code>[[Kotlin/kotlin.text/fold|fold()]]‎</code>: تجمِّع تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.
-* <code>[[Kotlin/kotlin.text/fold|fold()]]‎</code>: تُراكِم الدالة<code>fold()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة الراهنة وعلى الحرف الموالي في  سلسلة الحروف التي استُدعيت عبرها. ثم تُعيد القيمة النهائية.
-* <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]‎</code>: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/for-each.html الدالة text.forEach()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/for-each.html صفحة الدالة CharSequence.forEach()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]