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

من موسوعة حسوب
لا ملخص تعديل
مراجعة وتدقيق.
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع CharSequence.subSequence()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE:الدالة <code>CharSequence.subSequence()‎</code> في Kotlin}}</noinclude>
يعيد التابع <code>subSequence()‎‎</code> الجزء المحدد بالوسيطين المُمرّرين <code>startIndex</code> و  <code>endIndex</code> من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها،
تجلب الدالة <code>subSequence()‎‎</code> جزءًا محددًا يقع في [[Kotlin/CharSequence|سلسلة الحروف]] التي استٌدعيت معها.
== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
سطر 8: سطر 8:
): CharSequence
): CharSequence
</syntaxhighlight>
</syntaxhighlight>
== القيمة المُعادة ==
== القيمة المعادة ==
[[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>) {
fun main(args: Array<String>) {
val s = "hsoubAcademy"   
val s = "hsoubAcademy"   
سطر 23: سطر 21:


== انظر أيضًا ==
== انظر أيضًا ==
* الخاصيّة <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/sub-sequence.html التابع CharSequence.subSequence في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/sub-sequence.html صفحة الدالة ()subSequence في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
[[تصنيف:Kotlin Method]]

مراجعة 17:48، 13 أغسطس 2018

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

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

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

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

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

أمثلة

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

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

انظر أيضًا

مصادر