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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 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">
 
<syntaxhighlight lang="kotlin">
 
inline fun CharSequence.forEach(
 
inline fun CharSequence.forEach(
 
     action: (Char) -> Unit)
 
     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>) {
 
fun main(args: Array<String>) {
 
     val str = "Hsoub wiki"
 
     val str = "Hsoub wiki"
  
     str.forEach {print(it)} // Hsoub wiki
+
     str.forEach {print("$it:")} // H:s:o:u:b: :w:i:k:i:
 
}
 
}
 
</syntaxhighlight>
 
</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]]
[[تصنيف:Kotlin Functions]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin CharSequence]]

المراجعة الحالية بتاريخ 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(): تجمِّع تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.

مصادر