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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.subSequence()‎</code> في لغة Kotlin}}</noinclude> في حال استدعاء الدالة <code>subSequence()...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.subSequence()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>text.subSequence()‎</code> في لغة Kotlin}}</noinclude>
في حال استدعاء الدالة <code>subSequence()‎</code> عبر [[Kotlin/CharSequence/index|سلسلة حروف]] مع تمرير <code>delimiters</code> كوسيط فستعيد سلسلة (sequence) مكونة من  [[Kotlin/String|السلاسل النصية]] الموجودة حول المُحدِّدات المُتضمّنة في <code>delimiters.</code>  
تعيد الدالة <code>subSequence()‎</code> جزءًا من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والمُحدّد بمجال الفهارس المُمرّر <code>range</code><code>.</code>  
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
fun CharSequence.splitToSequence(
fun CharSequence.subSequence(range: IntRange): CharSequence  
    vararg delimiters: String,
    ignoreCase: Boolean = false,
    limit: Int = 0
): Sequence<String>
</syntaxhighlight>في حال استدعاء  الدالة <code>splitToSequence()‎</code> عبر [[Kotlin/CharSequence/index|سلسلة حروف]] مع تمرير [[Kotlin/String|سلسلة نصية]] <code>delimiters</code> كوسيط فستعيد سلسلة (sequence ) مكونة من  [[Kotlin/String|السلاسل النصية]] الموجودة حول المُحدِّدات المُتضمّنة في <code>delimiters.</code> الوسيط <code>limit</code> يحدد الحد الأقصى لعدد  [[Kotlin/String|السلاسل النصية]] في السلسلة المُعادة. والوسيط <code>ignoreCase </code>يحدد ما إذا كانت الدالة ستتجاهل حالة الأحرف (أي لا تفرق بين الحروف الصغيرة والكبيرة).
 
لتجنب الالتباس عندما تحتوي السلاسل النصية الموجودة في الوسيط المُمرّر <code>delimiters</code> حروفا مشتركة، فإنّ الدالة <code>findAnyOf()</code>‎ تبدأ من بداية تلك السلسلة النصية نحو نهايتها، وتبحث عند كل موضع عن العنصر الأول في <code>delimiters</code>والذي يطابق أحد العناصر  الموجودة في <code>delimiters</code>عند ذلك الموضع.<syntaxhighlight lang="kotlin">
fun CharSequence.split(
    vararg delimiters: Char,
    ignoreCase: Boolean = false,
    limit: Int = 0
): List<String>
</syntaxhighlight>في حال استدعاء  الدالة <code>splitToSequence()‎</code> عبر [[Kotlin/CharSequence/index|سلسلة حروف]] مع تمرير سلسلة الحروف  <code>delimiters</code> فستعيد سلسلة (sequence ) مكونة من  [[Kotlin/String|السلاسل النصية]] الموجودة حول المُحدِّدات المُتضمّنة في <code>delimiters.</code> الوسيط <code>limit</code> يحدد الحد الأقصى لعدد  [[Kotlin/String|السلاسل النصية]] في اللائحة المُعادة. والوسيط <code>ignoreCase </code>يحدد ما إذا كانت الدالة ستتجاهل حالة الأحرف (أي لا تفرق بين الحروف الصغيرة والكبيرة).
 


</syntaxhighlight>
==القيم المعادة==
==القيم المعادة==
سلسلة (sequence ) مكونة [[Kotlin/String|سلاسل نصية]].  
[[Kotlin/CharSequence/index|سلسلة حروف]].  
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()subSequence</code> مع سلسلة نصية===
===استخدام الدالة <code>()subSequence</code> مع سلسلة نصية===
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()subSequence</code> عبرها مع تمرير [[Kotlin/String|سلسلة نصية]] <nowiki/>كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()subSequence</code> عبرها مع تمرير مجال <nowiki/>كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val str = "wiki.hsoub.com"
val str = "wiki.hsoub.com"
      
      
println(str.splitToSequence(".").toList()) // [wiki, hsoub, com]
println(str.subSequence(5..9)) // hsoub
}
}
</syntaxhighlight>
</syntaxhighlight>
سطر 37: سطر 24:


==مصادر==
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/split-to-sequence.html الدالة text.subSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/sub-sequence.html الدالة text.subSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Functions]]

مراجعة 13:23، 12 يوليو 2018

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

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

fun CharSequence.subSequence(range: IntRange): CharSequence

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

سلسلة حروف.

أمثلة

استخدام الدالة ()subSequence مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()subSequence عبرها مع تمرير مجال كوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
val str = "wiki.hsoub.com"
    
println(str.subSequence(5..9)) // hsoub
}

انظر أيضًا

مصادر