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