الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/asIterable»
< Kotlin | kotlin.text
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة | <noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.asIterable()</code> في Kotlin}}</noinclude> | ||
تنشئ الدالة <code>asIterable()</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"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 7: | سطر 7: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد نسخة من الواجهة [[Kotlin/collections/Iterable|<code>Iterable</code>]] التي تغلّف [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة لاستعمالها في الحلقات التكرارية. | |||
==أمثلة== | ==أمثلة== | ||
تعرّف الشيفرة التالية [[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"> | |||
تعرّف الشيفرة التالية [[Kotlin/String|سلسلة نصية]] | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val str = "hsoub" | val str = "hsoub" | ||
val iter = str.asIterable() // إنشاء عنصر تكراري | val iter = str.asIterable() // إنشاء عنصر تكراري | ||
for (i in iter) | for (i in iter) | ||
print("$i.") // h.s.o.u.b. | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
*<code>[[Kotlin/kotlin.text/ | *الدالة <code>[[Kotlin/kotlin.text/iterator|iterator()]]</code>: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف [[Kotlin/CharSequence|السلسلة]] المستدعاة معه. | ||
*<code>[[Kotlin/kotlin.text/ | *الدالة <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>). | ||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/as-iterable.html الدالة | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/as-iterable.html صفحة الدالة CharSequence.asIterable() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Text]] | |||
[[تصنيف:Kotlin CharSequence]] | |||
المراجعة الحالية بتاريخ 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).