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

المراجعة الحالية بتاريخ 06:45، 9 سبتمبر 2018

تجلب الدالة subSequence()‎‎ جزءًا محددًا يقع في سلسلة الحروف التي استٌدعيت معها.

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

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

المعاملات

`startIndex`

عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية الجزء المراد جلبه.

`endIndex`

عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية الجزء المراد جلبه (لا يدخل هذا المحرف ضمن المجال).

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

يعاد الجزء الواقع بين الحرف ذي الفهرس startIndex والحرف ذي الفهرس endIndex في سلسلة المحارف المعطاة.

أمثلة

استعمال الدالة subSequence()‎‎ لجلب الجزء الواقع بين الحرف الرابع والحرف الثامن من سلسلة الحروف "hsoubAcademy":

fun main(args: Array<String>) {
val s = "hsoubAcademy"   
    
println(s.subSequence(3,7)) // ubAc
}

انظر أيضًا

الخاصيّة CharSequence.length: تمثل عدد عناصر سلسلة الحروف التي استٌدعيت معها.
الدالة ()get: تجلب العنصر ذي الفهرس الممرَّر إليها من سلسلة الحروف المستدعاة معها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع CharSequence.subSequence()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE:الدالة <code>CharSequence.subSequence()‎</code> في Kotlin}}</noinclude>
-يعين التابع <code>subSequence()‎‎</code> قيمة العنصر في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها عند الفهرس (index) المُحدَّد،
+تجلب الدالة <code>subSequence()‎‎</code> جزءًا محددًا يقع في [[Kotlin/CharSequence|سلسلة الحروف]] التي استٌدعيت معها.
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
-abstract operator fun get(index: Int): Char
+abstract fun subSequence(
+    startIndex: Int,
+    endIndex: Int
+): CharSequence
+</syntaxhighlight>
+== المعاملات ==
+=== <code>startIndex</code> ===
+عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية الجزء المراد جلبه.
-</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا.
+=== <code>endIndex</code> ===
+عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية الجزء المراد جلبه (لا يدخل هذا المحرف ضمن المجال).
-== القيمة المُعادة ==
+== القيمة المعادة ==
-العنصر عند الفهرس (index) المُحدَّد في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
+يعاد الجزء الواقع بين الحرف ذي الفهرس <code>startIndex</code> والحرف ذي الفهرس <code>endIndex</code> في [[Kotlin/CharSequence/index|سلسلة المحارف]] المعطاة.
 == أمثلة ==
+استعمال الدالة <code>subSequence()‎</code>‎ لجلب الجزء الواقع بين الحرف الرابع والحرف الثامن من سلسلة الحروف <code>"hsoubAcademy"</code>:<syntaxhighlight lang="kotlin">
-=== استخدام <code>subSequence()‎</code> على سلسلة نصية ===
-تُنشِئ الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>s</code>، ثم  تستدعي <code>subSequence()‎</code>‎ عبرها:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val s = "hsoub"
+val s = "hsoubAcademy"
-println(s.get(3)) // u
+println(s.subSequence(3,7)) // ubAc
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* الخاصيّة <code>[[Kotlin/CharSequence/length|CharSequence.length]]</code>: تعيد الخاصية <code>length‎</code> عدد عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
+* الخاصيّة <code>[[Kotlin/CharSequence/length|CharSequence.length]]</code>: تمثل عدد عناصر [[Kotlin/CharSequence|سلسلة الحروف]] التي استٌدعيت معها.
+* الدالة <code>[[Kotlin/CharSequence/get|()get]]</code>: تجلب العنصر ذي الفهرس الممرَّر إليها من [[Kotlin/CharSequence|سلسلة الحروف]] المستدعاة معها.
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/get.html التابع CharSequence.subSequence في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/sub-sequence.html صفحة الدالة ()subSequence في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin CharSequence]]