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

المراجعة الحالية بتاريخ 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).

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.lineSequence()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>CharSequence.lineSequence()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>lineSequence()</code>‎ آخر حروف في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها، وفي حال تمرير شرط منطقي فستعيد آخر حرف يحقق ذلك الشرط.
+تقسّم الدالة <code>lineSequence()</code>‎ [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/sequences/Sequence|سلسلة]] وتضع في عناصرها الأسطر المفصولة بأيٍّ من [[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|حرف]].
+تعاد [[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> عبرها مرة بدون وسيط ومرة بتمرير دالة منطقية كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
-fun main(args: Array<String>) {
+     val str = "Hsoub\nWiki\nAcademy"
-     val str = "hsoUb"
-     print(str.last()) // b
+     for (line in str.lineSequence())
-    print( str.last { it.isUpperCase() } ) // U
+        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/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/last.html صفحة الدالة text.lineSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/line-sequence.html صفحة الدالة CharSequence.lineSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]