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

مراجعة 10:40، 10 يوليو 2018

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

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

fun CharSequence.lineSequence(): Sequence<String>

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

كائن من Sequence.

أمثلة

استخدام الدالة `lineSequence()‎` مع السلاسل النصية

تُعرّف الشيفرة الآتية سلسلة نصية باسم str، ثم تستدعي الدالة lineSequence()‎ عبرها وتستخدم الناتج في الحلقة التكرارية for:

fun main(args: Array<String>) {
val str = "Hsoub\nWiki\nacademy" 
    
for (line in str.lineSequence())   print("$line ") // Hsoub Wiki academy 
}

انظر أيضًا

isEmpty()‎: تعيد الدالة isEmpty()‎ القيمة true في حال كانت سلسلة الحروف التي استٌدعيت عبرها فارغة.
isHighSurrogate()‎: تعيد القيمة true في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: التابع text.lineSequence()‎ في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>lineSequence()</code>‎ آخر حروف في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها، وفي حال تمرير شرط منطقي فستعيد آخر حرف يحقق ذلك الشرط.
+تقسّم الدالة <code>lineSequence()</code>‎ [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها إلى سلسلة مكونة سطور مفصولة بأيّ من [[Kotlin/CharSequence/index|سلاسل الحروف]] التالية <code>CRLF</code> أو  <code>LF</code> أو <code>CR</code>.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.last(): Char (source)
+fun CharSequence.lineSequence(): Sequence<String>
-inline fun CharSequence.last(
+</syntaxhighlight>
-    predicate: (Char) -> Boolean
-): Char
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inlinشe</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المعادة==
-[[Kotlin/Char/index|حرف]].
+كائن من <code>Sequence</code>.
 ==أمثلة==
 ===استخدام الدالة <code>lineSequence()‎</code> مع السلاسل النصية===
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</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>) {
-    val str = "hsoUb"
+val str = "Hsoub\nWiki\nacademy"
-    print(str.last()) // b
+for (line in str.lineSequence())   print("$line ") // Hsoub Wiki academy
-    print( str.last { it.isUpperCase() } ) // U
 }
 </syntaxhighlight>
 ==انظر أيضًا==
@@ سطر 27: / سطر 22: @@
 *<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/last.html صفحة الدالة text.lineSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/line-sequence.html صفحة الدالة text.lineSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]