الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/withIndex»
< Kotlin | kotlin.text
ط استبدال النص - 'Kotlin Functions' ب'Kotlin Function' |
جميل-بيلوني (نقاش | مساهمات) مراجعة وتدقيق. |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code> | <noinclude>{{DISPLAYTITLE: الدالة <code>withIndex()</code> في Kotlin}}</noinclude> | ||
تعيد | تعيد الدالة <code>withIndex()</code> مجموعة تكرارية خاملة (lazy Iterable) من [[Kotlin/collections/IndexedValue|القيم المُفهرسة]] لكل محرف من محارف [[Kotlin/CharSequence/index|السلسلة]] التي استُدعيت معها. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
سطر 7: | سطر 7: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد <nowiki/>[[Kotlin/Iterable|مجموعة تكرارية]] خاملة (lazy Iterable) من [[Kotlin/collections/IndexedValue|القيم المُفهرسة]] لكل محرف من محارف [[Kotlin/CharSequence/index|السلسلة]] المعطاة. | |||
==أمثلة== | ==أمثلة== | ||
مثالٌ على استعمال الدالة <code>()withIndex</code> مع [[Kotlin/String|سلسلة نصية]] ثم إسناد الناتج الذي تعيده إلى المتغير <code>iter</code>، لاستخدامه في حلقة تكرارية [[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|<code>for</code>]]:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val iter = "hsoub".withIndex() | val iter = "hsoub".withIndex() | ||
for (x in iter) println(x) | for (x in iter) println(x) | ||
// المخرجات | // المخرجات | ||
//IndexedValue(index=0, value=h) | //IndexedValue(index=0, value=h) | ||
//IndexedValue(index=1, value=s) | //IndexedValue(index=1, value=s) | ||
//IndexedValue(index=2, value=o) | //IndexedValue(index=2, value=o) | ||
//IndexedValue(index=3, value=u) | //IndexedValue(index=3, value=u) | ||
//IndexedValue(index=4, value=b) | //IndexedValue(index=4, value=b) | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* <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/iterator|iterator()]]</code>: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] المستدعاة معه. | |||
* <code>[[Kotlin/kotlin.text/ | |||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/with-index.html الدالة | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/with-index.html صفحة الدالة withIndex() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Function]] | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Text]] |
المراجعة الحالية بتاريخ 06:58، 7 سبتمبر 2018
تعيد الدالة withIndex()
مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف السلسلة التي استُدعيت معها.
البنية العامة
fun CharSequence.withIndex(): Iterable<IndexedValue<Char>>
القيم المعادة
تعاد مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف السلسلة المعطاة.
أمثلة
مثالٌ على استعمال الدالة ()withIndex
مع سلسلة نصية ثم إسناد الناتج الذي تعيده إلى المتغير iter
، لاستخدامه في حلقة تكرارية for
:
fun main(args: Array<String>) {
val iter = "hsoub".withIndex()
for (x in iter) println(x)
// المخرجات
//IndexedValue(index=0, value=h)
//IndexedValue(index=1, value=s)
//IndexedValue(index=2, value=o)
//IndexedValue(index=3, value=u)
//IndexedValue(index=4, value=b)
}
انظر أيضًا
- الدالة
asIterable()
: تنشئ نسخةً من الواجهةIterable
التي تغلّف سلسلة المحارف التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثلfor
). - الدالة
iterator()
: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف السلسلة المستدعاة معه.