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

المراجعة الحالية بتاريخ 10:31، 1 سبتمبر 2018

تقتطع الدالة subSequence()‎ جزءًا محددًا من سلسلة محارف الكائن StringBuilder وتعيدها.

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

actual fun subSequence(
    startIndex: Int, 
    endIndex: Int
): CharSequence

منصة التشغيل المطلوبة: JS.

حلت الدالة CharSequence.subSequence مكان هذه الدالة.

المعاملات

`startIndex`

عدد صحيح يحدد فهرس المحرف الذي يمثل بداية الجزء المراد اقتطاعه من محتوى الكائن StringBuilder.

`endIndex`

عدد صحيح يحدد فهرس المحرف (لا يدخل ضمن المجال) الذي يمثل نهاية الجزء المراد اقتطاعه من محتوى الكائن StringBuilder.

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

تعاد سلسلة محارف تحتوي على الجزء المقتطع من الكائن StringBuilder والمحدد بالمحرف ذي الفهرس startIndex والمحرف ذي الفهرس EndIndex (لا يدخل هذا المحرف ضمن المجال).

أمثلة

استعمال الدالة subSequence()‎ لاقتطاع جزء محدد من محتوى الكائن StringBuilder:

fun main(args: Array<String>) {
    val sb = StringBuilder("Academy")
    
    println(sb.subSequence(2,5)) // => ade
}

انظر أيضًا

الدالة append()‎: تضيف محرفًا أو سلسلة نصية أو أيَّ كائن آخر إلى الكائن StringBuilder.
الدالة toString()‎: تحول الكائن StringBuilder إلى سلسلة نصية.
الدالة get()‎: تجلب محرفًا ذا فهرس محدَّدٍ من سلسلة محارف الكائن StringBuilder.
الدالة reverse()‎: تعكس ترتيب محارف الكائن StringBuilder.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>StringBuilder.subSequence()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>StringBuilder.subSequence()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>subSequence()‎</code> نسخة من الصنف [[Kotlin/kotlin.text/StringBuilder/index|StringBuilder]]  مشابهة للكائن الذي استُدعيت عبره مع عكس حروفه.
+تقتطع الدالة <code>subSequence()‎</code> جزءًا محددًا من سلسلة محارف الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]] وتعيدها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-actual fun reverse(): StringBuilder
+actual fun subSequence(
+    startIndex: Int,
+    endIndex: Int
+): CharSequence
+</syntaxhighlight>'''منصة التشغيل المطلوبة''': JS.
-</syntaxhighlight>
+حلت الدالة <code>[[Kotlin/CharSequence/subSequence|CharSequence.subSequence]]</code> مكان هذه الدالة.
-==القيمة المُعادة==
-نسخة من الصنف [[Kotlin/kotlin.text/StringBuilder/index|StringBuilder]] .
+==المعاملات==
+=== <code>startIndex</code> ===
+[[Kotlin/Int|عدد صحيح]] يحدد فهرس المحرف الذي يمثل بداية الجزء المراد اقتطاعه من محتوى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]].
+=== <code>endIndex</code> ===
+[[Kotlin/Int|عدد صحيح]] يحدد فهرس المحرف (لا يدخل ضمن المجال) الذي يمثل نهاية الجزء المراد اقتطاعه من محتوى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]].
+==القيمة المعادة==
+تعاد [[Kotlin/CharSequence/index|سلسلة محارف]] تحتوي على الجزء المقتطع من الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]] والمحدد بالمحرف ذي الفهرس <code>startIndex</code> والمحرف ذي الفهرس <code>EndIndex</code> (لا يدخل هذا المحرف ضمن المجال).
 ==أمثلة==
-===استخدام الدالة <code>subSequence()‎</code>===
+استعمال الدالة <code>subSequence()‎</code> لاقتطاع جزء محدد من محتوى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]]:<nowiki/><syntaxhighlight lang="kotlin">
-تُنشِئ الشيفرة الآتية كائنًا من النوع <code>StringBuilder</code>باسم <code>sb</code>، ثم تستدعي  الدالة<code>subSequence()‎</code> عبر  <code>sb</code>، ثم تطبع الناتج:<nowiki/><syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val sb = StringBuilder("hsoub")
+     val sb = StringBuilder("Academy")
-     println(sb.reverse()) // => buosh
+     println(sb.subSequence(2,5)) // => ade
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-* الخاصية <code>[[Kotlin/kotlin.text/StringBuilder/length|length]]:</code>تعيد عدد عناصر سلسلة الحروف التي استٌدعيت عبرها.
+*الدالة <code>[[Kotlin/kotlin.text/StringBuilder/append|append()‎]]</code>: تضيف محرفًا أو [[Kotlin/String|سلسلة نصية]] أو أيَّ كائن آخر إلى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]].
-* <code>[[Kotlin/kotlin.text/StringBuilder/append|append()‎]]</code>: تضم  [[Kotlin/String|السلسلة النصية]] أو الحرف أو الكائن المُمرّر إليها إلى الكائن الذي استُدعيت عبره، وفي حال تمرير  عددين <code>start</code> و  <code>end</code> كوسيطين، فإنها تضم فقط جزء من  [[Kotlin/String|السلسلة النصية]] المحدد بذانك الوسيطين.
+*الدالة <code>[[Kotlin/kotlin.text/StringBuilder/toString|toString()‎]]</code>: تحول الكائن <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code> إلى [[Kotlin/String|سلسلة نصية]].
+*الدالة <code>[[Kotlin/kotlin.text/StringBuilder/get|get()‎]]</code>: تجلب محرفًا ذا فهرس محدَّدٍ من [[Kotlin/CharSequence/index|سلسلة محارف]] الكائن <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code>.
-* <code>[[Kotlin/kotlin.text/StringBuilder/get|get()‎]]</code>: تعيد الحرف الموجود عند الفهرس المُمرّر <code>index</code> في سلسلة الحروف التي استُدعيت عبرها.
+*الدالة <code>[[Kotlin/kotlin.text/StringBuilder/reverse|reverse()‎]]</code>: تعكس ترتيب محارف الكائن [[Kotlin/kotlin.text/StringBuilder/index|<code>StringBuilder</code>]].
-*
-* صفحة الصنف <code>[[Kotlin/kotlin.text/StringBuilder/index|StringBuilder]]</code>.
 ==مصادر==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-string-builder/-string-builder/reverse.html الدالة  StringBuilder.subSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-string-builder/-string-builder/sub-sequence.html صفحة الدالة StringBuilder.subSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Methods]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin StringBuilder]]