الفرق بين المراجعتين ل"Kotlin/kotlin.text/asSequence"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة text.asSequence()‎ في لغة Kotlin}}</noinclude> تنشئ الدالة <code>asSequence()‎</code> كائنًا من ال...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة text.asSequence()‎ في لغة Kotlin}}</noinclude>
 
<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">
 
<syntaxhighlight lang="kotlin">
fun CharSequence.asIterable(): Iterable<Char>
+
fun CharSequence.asSequence(): Sequence<Char>  
  
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==القيم المعادة==
 
==القيم المعادة==
كائن من الصنف <code>Iterable</code>.
+
كائن من الصنف <code>Sequence</code>.
 
==أمثلة==
 
==أمثلة==
 
===استخدام الدالة<code>asSequence()‎</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>) {
 
fun main(args: Array<String>) {
 
val str = "hsoub"
 
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.
 
     print("$i.") // h.s.o.u.b.
 
}
 
}
سطر 25: سطر 25:
 
*<code>[[Kotlin/kotlin.text/String|String()]]‎</code>: تحو المصفوفة الممررة إلى [[Kotlin/String|سلسلة نصية]].
 
*<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]]
 
[[تصنيف:Kotlin Method]]
 
[[تصنيف:Kotlin Method]]

مراجعة 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
  • asIterable(): تنشئ كائنًا من الصنف Iterable والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر