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

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

تنشئ الدالة asIterable()‎ نسخةً من الواجهة Iterable التي تغلّف سلسلة المحارف التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل for).

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

fun CharSequence.asIterable(): Iterable<Char>

القيم المعادة

تعاد نسخة من الواجهة Iterable التي تغلّف سلسلة المحارف المعطاة لاستعمالها في الحلقات التكرارية.

أمثلة

تعرّف الشيفرة التالية سلسلة نصية باسم str ثم تستدعي الدالة asIterable()‎ معها وتحيل القيمة المُعادة إلى المتغير iter لطباعة كل محرف من محارف تلك السلسلة باستخدام الحلقة التكرارية for:

fun main(args: Array<String>) {
    val str = "hsoub"
    val iter = str.asIterable() // إنشاء عنصر تكراري

    for (i in iter)
        print("$i.") // h.s.o.u.b.
}

انظر أيضًا

الدالة iterator()‎: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف السلسلة المستدعاة معه.
الدالة asSequence()‎: تُنشِئ نسخةً من الواجهة Sequence التي تغلّف سلسلة المحارف التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة for).

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة text.asIterable()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.asIterable()‎</code> في Kotlin}}</noinclude>
-تضم الدالة <code>asIterable()‎</code> الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف <code>[[Kotlin/kotlin.text/java.lang.Appendable/index|Appendable]]</code>.
+تنشئ الدالة <code>asIterable()‎</code> نسخةً من الواجهة <code>[[Kotlin/collections/Iterable|Iterable]]</code> التي تغلّف [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun <T> T.append(vararg value: CharSequence?): T
+fun CharSequence.asIterable(): Iterable<Char>
 </syntaxhighlight>
 ==القيم المعادة==
-كائن من الصنف <code>[[Kotlin/kotlin.text/java.lang.Appendable/index|Appendable]]</code>.
+تعاد نسخة من الواجهة [[Kotlin/collections/Iterable|<code>Iterable</code>]] التي تغلّف [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة لاستعمالها في الحلقات التكرارية.
 ==أمثلة==
-===استخدام الدالة<code>asIterable()‎</code>===
+تعرّف الشيفرة التالية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code> ثم تستدعي الدالة <code>asIterable()‎</code> معها وتحيل القيمة المُعادة إلى المتغير <code>iter</code> لطباعة كل محرف من محارف تلك السلسلة باستخدام الحلقة التكرارية <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>:<syntaxhighlight lang="kotlin">
-تعرّف الشيفرة التالية كائنًا من النوع <code>[[Kotlin/kotlin.text/java.lang.StringBuilder/index|StringBuilder]]</code>  باسم <code>str</code>، ثم تستدعي الدالة<code>asIterable()‎</code>  عبره مع تمرير [[Kotlin/String|سلسلة نصية]] كوسيط، ثم نطبَع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = StringBuilder("hsoub")
+    val str = "hsoub"
+    val iter = str.asIterable() // إنشاء عنصر تكراري
-println(str.append(" academy")) // hsoub academy
+    for (i in iter)
+        print("$i.") // h.s.o.u.b.
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/kotlin.text/all|all()]]‎</code>: تعيد الدالة <code>all()‎</code> القيمة <code>true</code>  إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+*الدالة <code>[[Kotlin/kotlin.text/iterator|iterator()‎]]</code>: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف [[Kotlin/CharSequence|السلسلة]] المستدعاة معه.
+*الدالة <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تُنشِئ نسخةً من الواجهة <code>[[Kotlin/sequences/Sequence|Sequence]]</code> التي تغلّف [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
-*<code>[[Kotlin/kotlin.text/String|String()]]‎</code>: تحو المصفوفة الممررة إلى [[Kotlin/String|سلسلة نصية]].
-*<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
-*الخاصية <code>[[Kotlin/kotlin.text/indices|indices]]</code>: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/append.html الدالة text.asIterable()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/as-iterable.html صفحة الدالة CharSequence.asIterable()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]