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

مراجعة 16:49، 7 يوليو 2018

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

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

fun CharSequence.asIterable(): Iterable<Char>

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

كائن من الصنف Iterable.

أمثلة

استخدام الدالة`asIterable()‎`

تعرّف الشيفرة التالية سلسلة نصية باسم 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.
}

انظر أيضًا

append()‎:تضم الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف Appendable.
all()‎: تعيد الدالة all()‎ القيمة true إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر predicate.

String()‎: تحو المصفوفة الممررة إلى سلسلة نصية.

isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

الخاصية indices: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة text.asIterable()‎ في لغة Kotlin}}</noinclude>
-تضم الدالة <code>asIterable()‎</code> الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف <code>[[Kotlin/kotlin.text/java.lang.Appendable/index|Appendable]]</code>.
+تنشئ الدالة <code>asIterable()‎</code>  كائنًا من الصنف <code>Iterable</code> والذي يُغلّف [[CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، لأجل استعمالها في الحلقة التكرارية <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>.
+كائن من الصنف <code>Iterable</code>.
 ==أمثلة==
 ===استخدام الدالة<code>asIterable()‎</code>===
-تعرّف الشيفرة التالية كائنًا من النوع <code>[[Kotlin/kotlin.text/java.lang.StringBuilder/index|StringBuilder]]</code>  باسم <code>str</code>، ثم تستدعي الدالة<code>asIterable()‎</code>  عبره مع تمرير [[Kotlin/String|سلسلة نصية]] كوسيط، ثم نطبَع الناتج:<syntaxhighlight lang="kotlin">
+تعرّف الشيفرة التالية [[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">
 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/append|append()]]‎</code>:تضم الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف <code>Appendable</code>.
 *<code>[[Kotlin/kotlin.text/all|all()]]‎</code>: تعيد الدالة <code>all()‎</code> القيمة <code>true</code>  إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
@@ سطر 26: / سطر 29: @@
 *الخاصية <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 الدالة text.asIterable()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]