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

من موسوعة حسوب
لا ملخص تعديل
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة text.asIterable()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة text.asIterable()‎ في لغة Kotlin}}</noinclude>
تنشئ الدالة <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>.
تنشئ الدالة <code>asIterable()‎</code>  كائنًا من الصنف <code>Iterable</code> والذي يُغلّف [[CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
سطر 10: سطر 10:
==أمثلة==
==أمثلة==
===استخدام الدالة<code>asIterable()‎</code>===
===استخدام الدالة<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">
تعرّف الشيفرة التالية [[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>) {
fun main(args: Array<String>) {
val str = "hsoub"
val str = "hsoub"
سطر 23: سطر 23:
*<code>[[Kotlin/kotlin.text/all|all()]]‎</code>: تعيد الدالة <code>all()‎</code> القيمة <code>true</code>  إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</code>. 
*<code>[[Kotlin/kotlin.text/all|all()]]‎</code>: تعيد الدالة <code>all()‎</code> القيمة <code>true</code>  إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</code>. 


*<code>[[Kotlin/kotlin.text/String|String()]]‎</code>: تحو المصفوفة الممررة إلى [[Kotlin/String|سلسلة نصية]].
*<code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ  كائنًا من الصنف <code>Sequence</code> والذي يُغلّف [[CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 
*<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/as-iterable.html الدالة text.asIterable()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/as-iterable.html الدالة text.asIterable()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
[[تصنيف:Kotlin Method]]

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

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

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

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
  • asSequence(): تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر