الفرق بين المراجعتين ل"Kotlin/CharArray/iterator"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
ط
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>CharArray.iterator()</code>‎ في Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>CharArray.iterator()</code>‎ في Kotlin}}</noinclude>
ينشئ التابع <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
+
تنشئ الدالة <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
  
 
== البنية العامة ==
 
== البنية العامة ==
سطر 6: سطر 6:
 
operator fun iterator(): CharIterator  
 
operator fun iterator(): CharIterator  
  
</syntaxhighlight>وجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل).
+
</syntaxhighlight>وجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل).
  
 
== القيم المعادة ==
 
== القيم المعادة ==
سطر 12: سطر 12:
  
 
== أمثلة ==
 
== أمثلة ==
استعمال التابع <code>iterator()‎</code> لتخصيص عنصر تكراري من أجل استخدامه في الحلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code> التكرارية التي تطبع قيم جميع العناصر:<syntaxhighlight lang="kotlin">
+
استعمال الدالة <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() }
سطر 26: سطر 26:
 
* الصنف <code>‎[[Kotlin/CharArray|CharArray]]</code>.
 
* الصنف <code>‎[[Kotlin/CharArray|CharArray]]</code>.
 
* الدالة <code>[[Kotlin/CharArray/Init|CharArray()‎]]</code>: تنشئ <nowiki/>[[Kotlin/Array|مصفوفة]] جديدة من النوع <code>[[Kotlin/CharArray|CharArray]]</code> (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة <code>'‎\u0000'</code> التي تمثل حرفًا عدميًّا.  
 
* الدالة <code>[[Kotlin/CharArray/Init|CharArray()‎]]</code>: تنشئ <nowiki/>[[Kotlin/Array|مصفوفة]] جديدة من النوع <code>[[Kotlin/CharArray|CharArray]]</code> (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة <code>'‎\u0000'</code> التي تمثل حرفًا عدميًّا.  
* التابع <code>[[Kotlin/CharArray/get|()get]]</code>: يجلب عنصرًا ذي فهرس محدد من المصفوفة.
+
* الدالة <code>[[Kotlin/CharArray/get|()get]]</code>: تجلب عنصرًا ذي فهرس محدد من المصفوفة.
  
* التابع <code>[[Kotlin/CharArray/set|()set]]</code>: يضبط قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
+
* الدالة <code>[[Kotlin/CharArray/set|()set]]</code>: تضبط قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
 
* الخاصية <nowiki/>[[Kotlin/CharArray/size|<code>CharArray.size</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 Function]]
 
[[تصنيف:Kotlin Function]]
 
[[تصنيف:Kotlin CharArray]]
 
[[تصنيف:Kotlin CharArray]]

المراجعة الحالية بتاريخ 06:30، 9 سبتمبر 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: تمثل عدد العناصر الموجودة في المصفوفة.

مصادر