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

من موسوعة حسوب
لا ملخص تعديل
طلا ملخص تعديل
 
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع text.lineSequence()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: التابع <code>CharSequence.lineSequence()‎</code> في Kotlin}}</noinclude>
تقسّم الدالة <code>lineSequence()</code>‎ [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها إلى سلسلة مكونة من سطور مفصولة بأيٍّ من [[Kotlin/CharSequence/index|سلاسل الحروف]] التالية <code>CRLF</code> أو <code>LF</code> أو <code>CR</code>.
تقسّم الدالة <code>lineSequence()</code>‎ [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/sequences/Sequence|سلسلة]] وتضع في عناصرها الأسطر المفصولة بأيٍّ من [[Kotlin/CharSequence/index|سلاسل المحارف]] التالية: <code>CRLF</code> أو <code>LF</code> أو <code>CR</code>.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
سطر 7: سطر 7:
</syntaxhighlight>
</syntaxhighlight>
==القيم المعادة==
==القيم المعادة==
كائن من <code>Sequence</code>.
تعاد [[Kotlin/collections/List|سلسلة]] من سلاسل نصية تحوي الأسطر المفصولة بأيٍّ من [[Kotlin/CharSequence/index|سلاسل المحارف]] التالية: <code>CRLF</code> أو  <code>LF</code> أو <code>CR</code>.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>lineSequence()‎</code> مع السلاسل النصية===
مثالٌ على استعمال الدالة <code>lineSequence()‎</code>:<syntaxhighlight lang="kotlin">
تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>lineSequence()‎</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\nWiki\nacademy"  
    val str = "Hsoub\nWiki\nAcademy"
      
 
for (line in str.lineSequence())  print("$line ") // Hsoub Wiki academy
     for (line in str.lineSequence())   
        print("$line ") // Hsoub Wiki Academy
}
}
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا==
==انظر أيضًا==
*<code>[[Kotlin/kotlin.text/lines|lines()]]‎</code>:تقسّم [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها إلى [[Kotlin/String|لائحة]] مكونة من سطور مفصولة بأيٍّ من [[Kotlin/CharSequence/index|سلاسل الحروف]] التالية <code>CRLF</code> أو <code>LF</code> أو <code>CR</code>.
*الدالة <code>[[Kotlin/kotlin.text/lines|lines()]]‎</code>:تقسّم [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/collections/List|قائمة]] وتضع في عناصرها الأسطر المفصولة بأيٍّ من [[Kotlin/CharSequence/index|سلاسل المحارف]] التالية: <code>CRLF</code> أو <code>LF</code> أو <code>CR</code>
*<code>[[Kotlin/text/isHighSurrogate|isHighSurrogate()]]</code>: تعيد القيمة <code>true</code> في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
*الدالة <code>[[Kotlin/kotlin.text/iterator|iterator()]]</code>: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] المستدعاة معه.
*<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
* الدالة <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تُنشِئ نسخةً من الواجهة <code>Sequence</code> التي تغلّف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
==مصادر==
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/line-sequence.html صفحة الدالة text.lineSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/line-sequence.html صفحة الدالة CharSequence.lineSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin CharSequence]]

المراجعة الحالية بتاريخ 07:48، 4 سبتمبر 2018

تقسّم الدالة lineSequence()سلسلة المحارف التي استٌدعيت معها إلى سلسلة وتضع في عناصرها الأسطر المفصولة بأيٍّ من سلاسل المحارف التالية: CRLF أو LF أو CR.

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

fun CharSequence.lineSequence(): Sequence<String>

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

تعاد سلسلة من سلاسل نصية تحوي الأسطر المفصولة بأيٍّ من سلاسل المحارف التالية: CRLF أو LF أو CR.

أمثلة

مثالٌ على استعمال الدالة lineSequence()‎:

fun main(args: Array<String>) {
    val str = "Hsoub\nWiki\nAcademy"

    for (line in str.lineSequence())   
        print("$line ") // Hsoub Wiki Academy 
}

انظر أيضًا

  • الدالة lines():تقسّم سلسلة المحارف التي استٌدعيت معها إلى قائمة وتضع في عناصرها الأسطر المفصولة بأيٍّ من سلاسل المحارف التالية: CRLF أو LF أو CR
  • الدالة iterator()‎: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف السلسلة المستدعاة معه.
  • الدالة asSequence(): تُنشِئ نسخةً من الواجهة Sequence التي تغلّف سلسلة المحارف التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة for).

مصادر