الفرق بين المراجعتين لصفحة: «Kotlin/CharArray/iterator»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) مراجعة وتدقيق. |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع CharArray.iterator() في | <noinclude>{{DISPLAYTITLE: التابع <code>CharArray.iterator()</code> في Kotlin}}</noinclude> | ||
ينشئ التابع <code>iterator()</code> عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. | |||
== البنية العامة == | == البنية العامة == | ||
سطر 7: | سطر 7: | ||
operator fun iterator(): CharIterator | operator fun iterator(): CharIterator | ||
</syntaxhighlight> | </syntaxhighlight>وجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل). | ||
== القيم المعادة == | == القيم المعادة == | ||
عنصرٌ | يعاد عنصرٌ تكراريٌٌ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. | ||
== أمثلة == | == أمثلة == | ||
استعمال التابع <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 f: (Int) -> Char = { x -> (x+97).toChar() } | val f: (Int) -> Char = { x -> (x + 97).toChar() } | ||
val array = CharArray(6, f) | val array = CharArray(6, f) | ||
val iter = array.iterator() | |||
for(element in iter) | |||
print("$element ") // a b c d e f | |||
for(element in iter) | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* | * الصنف <code>[[Kotlin/CharArray|CharArray]]</code>. | ||
* التابع <code>[[Kotlin/CharArray/get|()get]]</code>: | * الدالة <code>[[Kotlin/CharArray/Init|CharArray()]]</code>: تنشئ <nowiki/>[[Kotlin/Array|مصفوفة]] جديدة من النوع <code>[[Kotlin/CharArray|CharArray]]</code> (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة <code>'\u0000'</code> التي تمثل حرفًا عدميًّا. | ||
* التابع <code>[[Kotlin/CharArray/set|()set]]</code>: | * التابع <code>[[Kotlin/CharArray/get|()get]]</code>: يجلب عنصرًا ذي فهرس محدد من المصفوفة. | ||
* التابع <code>[[Kotlin/CharArray/set|()set]]</code>: يضبط قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه. | |||
* الخاصية <nowiki/>[[Kotlin/CharArray/size|<code>CharArray.size</code>]]: تمثل عدد العناصر الموجودة في المصفوفة. | |||
== مصادر == | == مصادر == | ||
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-array/iterator.html التابع CharArray.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-array/iterator.html صفحة التابع ()CharArray.iterator في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Method]] | [[تصنيف:Kotlin Method]] |
مراجعة 13:49، 10 أغسطس 2018
ينشئ التابع iterator()
عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
البنية العامة
operator fun iterator(): CharIterator
وجود الكلمة المفتاحية operator
يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل).
القيم المعادة
يعاد عنصرٌ تكراريٌٌ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة.
أمثلة
استعمال التابع iterator()
لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for
التكرارية التي تطبع قيم جميع العناصر:
fun main(args: Array<String>) {
val f: (Int) -> Char = { x -> (x + 97).toChar() }
val array = CharArray(6, f)
val iter = array.iterator()
for(element in iter)
print("$element ") // a b c d e f
}
انظر أيضًا
- الصنف
CharArray
. - الدالة
CharArray()
: تنشئ مصفوفة جديدة من النوعCharArray
(أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة'\u0000'
التي تمثل حرفًا عدميًّا. - التابع
()get
: يجلب عنصرًا ذي فهرس محدد من المصفوفة.
- التابع
()set
: يضبط قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه. - الخاصية
CharArray.size
: تمثل عدد العناصر الموجودة في المصفوفة.