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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة text.asSequence()‎ في لغة Kotlin}}</noinclude> تنشئ الدالة <code>asSequence()‎</code> كائنًا من ال...')
 
(مراجعة وتدقيق.)
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة text.asSequence()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.asSequence()‎</code> في 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>[[Kotlin/sequences/Sequence|Sequence]]</code> التي تغلّف [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
fun CharSequence.asIterable(): Iterable<Char>
+
fun CharSequence.asSequence(): Sequence<Char>  
  
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==القيم المعادة==
 
==القيم المعادة==
كائن من الصنف <code>Iterable</code>.
+
كائن من الصنف <code>[[Kotlin/sequences/Sequence|Sequence]]</code> التي تغلّف [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة لاستعمالها في الحلقات التكرارية.
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة<code>asSequence()‎</code>===
+
تعرّف الشيفرة التالية [[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">
تعرّف الشيفرة التالية [[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">
 
 
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.
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
*<code>[[Kotlin/kotlin.text/append|append()]]‎</code>:تضم الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف <code>Appendable</code>.
+
*الدالة <code>[[Kotlin/kotlin.text/asIterable|asIterable()]]‎</code>: تنشئ نسخةً من الواجهة <code>[[Kotlin/collections/Iterable|Iterable]]</code> التي تغلّف [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
*<code>[[Kotlin/kotlin.text/all|all()]]‎</code>: تعيد الدالة <code>all()‎</code> القيمة <code>true</code>  إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</code>. 
 
 
 
*<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/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 صفحة الدالة CharSequence.asSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin CharSequence]]

المراجعة الحالية بتاريخ 06:55، 2 سبتمبر 2018

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

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

fun CharSequence.asSequence(): Sequence<Char>

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

كائن من الصنف Sequence التي تغلّف سلسلة المحارف المعطاة لاستعمالها في الحلقات التكرارية.

أمثلة

تعرّف الشيفرة التالية سلسلة نصية باسم 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.
}

انظر أيضًا

  • الدالة asIterable(): تنشئ نسخةً من الواجهة Iterable التي تغلّف سلسلة المحارف التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل for).

مصادر