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

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

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

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

fun CharSequence.lines(): List<String>

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

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

أمثلة

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

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

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

انظر أيضًا

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

مصادر

صفحة الدالة CharSequence.lines()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.lines()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>CharSequence.lines()‎</code> في Kotlin}}</noinclude>
-تقسّم الدالة <code>lines()</code>‎ [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها إلى سلسلة مكونة سطور مفصولة بأيّ من [[Kotlin/CharSequence/index|سلاسل الحروف]] التالية <code>CRLF</code> أو  <code>LF</code> أو <code>CR</code>.
+تقسّم الدالة <code>lines()</code>‎ [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/collections/List|قائمة]] وتضع في عناصرها الأسطر المفصولة بأيٍّ من [[Kotlin/CharSequence/index|سلاسل المحارف]] التالية: <code>CRLF</code> أو <code>LF</code> أو <code>CR</code>.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.lineSequence(): Sequence<String>
+fun CharSequence.lines(): List<String>
 </syntaxhighlight>
 ==القيم المعادة==
-كائن من <code>Sequence</code>.
+تعاد [[Kotlin/collections/List|قائمة]] من سلاسل نصية تحوي الأسطر المفصولة بأيٍّ من [[Kotlin/CharSequence/index|سلاسل المحارف]] التالية: <code>CRLF</code> أو  <code>LF</code> أو <code>CR</code>.
 ==أمثلة==
-===استخدام الدالة <code>lines()‎</code> مع السلاسل النصية===
+مثال على استعمال الدالة <code>lines()‎</code>:<syntaxhighlight lang="kotlin">
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>lines()‎</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\nWiki\nacademy"
+    val str = "Hsoub\nWiki\nAcademy"
-for (line in str.lineSequence())   print("$line ") // Hsoub Wiki academy
+     for (line in str.lines())
+        print("$line ") // Hsoub Wiki Academy
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/kotlin.text/isEmpty|isEmpty()]]‎</code>: تعيد الدالة <code>isEmpty()</code>‎ القيمة <code>true</code> في حال كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها فارغة.
+*الدالة <code>[[Kotlin/kotlin.text/lineSequence|lineSequence()]]‎</code>: تقسّم [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/sequences/Sequence|سلسلة]] وتضع في عناصرها الأسطر المفصولة بأيٍّ من [[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).
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/line-sequence.html صفحة الدالة text.lines()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/lines.html صفحة الدالة CharSequence.lines()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]