الفرق بين المراجعتين ل"Kotlin/kotlin.text/iterator"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (مراجعة وتدقيق.) |
|||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: الدالة | + | <noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.iterator()</code> في Kotlin}}</noinclude> |
| − | + | تنشئ الدالة <code>iterator()</code> عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف [[Kotlin/CharSequence|السلسلة]] المستدعاة معه. | |
== البنية العامة == | == البنية العامة == | ||
| سطر 7: | سطر 7: | ||
operator fun CharSequence.iterator(): CharIterator | operator fun CharSequence.iterator(): CharIterator | ||
| − | </syntaxhighlight> | + | </syntaxhighlight>وجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذه الدالة مرتبطٌة بمعامل التكرار (iteration operator، اطلع على المثال في الأسفل). |
== القيم المعادة == | == القيم المعادة == | ||
| − | عنصرٌ تكراريٌّ (iterator) | + | يعاد عنصرٌ تكراريٌّ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. |
== أمثلة == | == أمثلة == | ||
| − | + | مثالٌ<nowiki/> على استعمال الدالة <code>iterator()</code>:<syntaxhighlight lang="kotlin"> | |
| − | |||
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val str = "Hsoub" | val str = "Hsoub" | ||
| سطر 27: | سطر 25: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * <code>[[Kotlin/kotlin.text/ | + | * الدالة <code>[[Kotlin/kotlin.text/asIterable|asIterable()]]</code>: تنشئ نسخةً من الواجهة <code>Iterable</code> التي تغلّف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>). |
| + | * الدالة <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]</code>: تُنشِئ نسخةً من الواجهة <code>Sequence</code> التي تغلّف <nowiki/>[[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/iterator.html | + | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/iterator.html صفحة الدالة CharSequence.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
| − | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
| + | [[تصنيف:Kotlin Text]] | ||
| + | [[تصنيف:Kotlin CharSequence]] | ||
مراجعة 06:56، 4 سبتمبر 2018
تنشئ الدالة iterator() عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف السلسلة المستدعاة معه.
البنية العامة
operator fun CharSequence.iterator(): CharIterator
وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل التكرار (iteration operator، اطلع على المثال في الأسفل).
القيم المعادة
يعاد عنصرٌ تكراريٌّ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة.
أمثلة
مثالٌ على استعمال الدالة iterator():
fun main(args: Array<String>) {
val str = "Hsoub"
val iter = str.iterator()
for(element in iter)
print("$element ") // H s o u b
}
انظر أيضًا
- الدالة
asIterable(): تنشئ نسخةً من الواجهةIterableالتي تغلّف سلسلة المحارف التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثلfor). - الدالة
asSequence(): تُنشِئ نسخةً من الواجهةSequenceالتي تغلّف سلسلة المحارف التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقةfor).