الفرق بين المراجعتين ل"Kotlin/kotlin.text/iterator"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة text.iterator() في لغة Kotlin}}</noinclude> يعيد التابع <code>iterator()</code> عنصرًا تكراريً...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة text.iterator() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة text.iterator() في لغة Kotlin}}</noinclude> | ||
| − | يعيد التابع <code>iterator()</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر | + | يعيد التابع <code>iterator()</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها. |
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| − | operator fun iterator(): | + | operator fun CharSequence.iterator(): CharIterator |
</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator). | </syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator). | ||
== القيم المعادة == | == القيم المعادة == | ||
| − | عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر | + | عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]]. |
== أمثلة == | == أمثلة == | ||
| − | === استخدام | + | === استخدام الدالة<code>iterator()</code> على سلسلة نصية === |
| − | تنشِئ الشيفرة الآتية | + | تنشِئ الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str،</code> ثم تخصِّص لهذه [[Kotlin/String|السلسلة النصية]]<nowiki/>عنصرًا تكراريًا (iterator) باستخدام الدالة<code>iterator()</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 | + | val str = "Hsoub" |
| − | val | + | val iter = str.iterator() |
| − | + | for(element in iter) | |
| + | print("$element ") // H s o u b | ||
| + | } | ||
| − | |||
| − | |||
| − | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * | + | * <code>[[Kotlin/kotlin.text/isEmpty|isEmpty()]]</code>: تعيد الدالة <code>isEmpty()</code> القيمة <code>true</code> في حال كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها فارغة. |
| − | |||
| − | |||
== مصادر == | == مصادر == | ||
| − | * [ | + | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/iterator.html التابع text.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Method]] | [[تصنيف:Kotlin Method]] | ||
مراجعة 09:26، 10 يوليو 2018
يعيد التابع iterator() عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر سلسلة الحروف التي استٌدعيت عبرها.
البنية العامة
operator fun CharSequence.iterator(): CharIterator
ويُلاحظ وجود الكلمة المفتاحية operator للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
القيم المعادة
عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر سلسلة الحروف.
أمثلة
استخدام الدالةiterator() على سلسلة نصية
تنشِئ الشيفرة الآتية سلسلة نصية باسم str، ثم تخصِّص لهذه السلسلة النصيةعنصرًا تكراريًا (iterator) باستخدام الدالةiterator() لاستخدامه في حلقة for:
fun main(args: Array<String>) {
val str = "Hsoub"
val iter = str.iterator()
for(element in iter)
print("$element ") // H s o u b
}
انظر أيضًا
isEmpty(): تعيد الدالةisEmpty() القيمةtrueفي حال كانت سلسلة الحروف التي استٌدعيت عبرها فارغة.