الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/asSequence»

مراجعة 16:55، 7 يوليو 2018

تنشئ الدالة asSequence()‎ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

البنية العامة

fun CharSequence.asSequence(): Sequence<Char>

القيم المعادة

كائن من الصنف Sequence.

أمثلة

استخدام الدالة`asSequence()‎`

تعرّف الشيفرة التالية سلسلة نصية باسم str، ثم تستدعي الدالةasSequence()‎ عبرها وتُحيل القيمة المُعادة إلى المتغير seq، ثم نطبَع الناتج باستخدام الحلقة التكرارية for:

fun main(args: Array<String>) {
val str = "hsoub"
val seq = str.asSequence() // إنشاء عنصر تكراري
 
for (i in seq) 
    print("$i.") // h.s.o.u.b.
}

انظر أيضًا

append()‎:تضم الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف Appendable.
all()‎: تعيد الدالة all()‎ القيمة true إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر predicate.

String()‎: تحو المصفوفة الممررة إلى سلسلة نصية.

asIterable()‎: تنشئ كائنًا من الصنف Iterable والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

الدالة text.asSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة text.asSequence()‎ في لغة Kotlin}}</noinclude>
-تنشئ الدالة <code>asSequence()‎</code>  كائنًا من الصنف <code>Iterable</code> والذي يُغلّف [[CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، لأجل استعمالها في الحلقة التكرارية <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>.
+تنشئ الدالة <code>asSequence()‎</code>  كائنًا من الصنف <code>Sequence</code> والذي يُغلّف [[CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.asIterable(): Iterable<Char>
+fun CharSequence.asSequence(): Sequence<Char>
 </syntaxhighlight>
 ==القيم المعادة==
-كائن من الصنف <code>Iterable</code>.
+كائن من الصنف <code>Sequence</code>.
 ==أمثلة==
 ===استخدام الدالة<code>asSequence()‎</code>===
-تعرّف الشيفرة التالية [[Kotlin/String|سلسلة نصية]]  باسم <code>str</code>، ثم تستدعي الدالة<code>asSequence()‎</code>  عبرها وتحيل القيمة المُعادة إلى المتغير <code>iter</code>، ، ثم نطبَع الناتج باستخدام الحلقة التكرارية <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>:<syntaxhighlight lang="kotlin">
+تعرّف الشيفرة التالية [[Kotlin/String|سلسلة نصية]]  باسم <code>str</code>، ثم تستدعي الدالة<code>asSequence()‎</code>  عبرها وتُحيل القيمة المُعادة إلى المتغير <code>seq</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>) {
 val str = "hsoub"
-val iter = str.asIterable() // إنشاء عنصر تكراري
+val seq = str.asSequence() // إنشاء عنصر تكراري
-for (i in iter)
+for (i in seq)
      print("$i.") // h.s.o.u.b.
 }
@@ سطر 25: / سطر 25: @@
 *<code>[[Kotlin/kotlin.text/String|String()]]‎</code>: تحو المصفوفة الممررة إلى [[Kotlin/String|سلسلة نصية]].
-*<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+*<code>[[Kotlin/kotlin.text/asIterable|asIterable()]]‎</code>: تنشئ  كائنًا من الصنف <code>Iterable</code> والذي يُغلّف [[CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
-*الخاصية <code>[[Kotlin/kotlin.text/indices|indices]]</code>: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/as-iterable.html الدالة text.asSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/as-sequence.html الدالة text.asSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]