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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.removeRange()‎</code> في لغة Kotlin}}</noinclude> إن كانت السلسلة النصية...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.removeRange()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>text.removeRange()‎</code> في لغة Kotlin}}</noinclude>
إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeRange()‎</code> تنتهي باللاحقة <code>suffix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك اللاحقة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.  
تعيد الدالة <code>removeRange()‎</code> [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها مع حذف جزء منها (انظر فقرة البنيةالعامة).  
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
fun CharSequence.removePrefix(
fun CharSequence.removeRange(
     prefix: CharSequence
     startIndex: Int,
    endIndex: Int
): CharSequence
): CharSequence
</syntaxhighlight>إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeRange()‎</code> تنتهي باللاحقة <code>suffix</code> فستعيد الدالةُ [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك اللاحقة، وإلا فستعيد [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.<syntaxhighlight lang="kotlin">
</syntaxhighlight>في حال استدعاء  الدالة <code>removeRange()‎</code> عبر [[Kotlin/CharSequence/index|سلسلة حروف]] مع تمرير عددين <code>startIndex</code> و <code>endIndex</code> كوسيطين فستعيد [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف الحروف التي فهرسها محصور بين <code>startIndex</code> و <code>endIndex.</code> تذكر أن <code>endIndex</code> ليس مُتضمّنا في الجزء المحذوف.<syntaxhighlight lang="kotlin">
fun String.removePrefix(prefix: CharSequence): String
inline fun String.removeRange(
    startIndex: Int,
    endIndex: Int
): String
</syntaxhighlight>في حال استدعاء  الدالة <code>removeRange()‎</code> عبر [[Kotlin/String|سلسلة نصية]] مع تمرير عددين <code>startIndex</code> و <code>endIndex</code> كوسيطين فستعيد [[Kotlin/String|سلسلة نصية]] جديدة مع حذف الحروف التي فهرسها محصور بين <code>startIndex</code> و <code>endIndex.</code> تذكّر أن <code>endIndex</code> ليس مُتضمّنا في الجزء المحذوف.<syntaxhighlight lang="kotlin">
fun CharSequence.removeRange(range: IntRange): CharSequence


</syntaxhighlight>إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها الدالة <code>removeRange()</code>تنتهي باللاحقة <code>suffix</code> فستعيد [[Kotlin/String|سلسلة نصية]] جديدة مع حذف تلك اللاحقة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]]  كما هي.
</syntaxhighlight>في حال استدعاء  الدالة <code>removeRange()‎</code> عبر [[Kotlin/CharSequence/index|سلسلة حروف]] مع تمرير مجال<code>range</code> من النوع <code>IntRange</code> كوسيط فستعيد  [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف الحروف التي فهرسها ينتمي إلى  المجال<code>range.</code> تذكر أنّ نهاية <code>range</code> مُتضمّنة في الجزء المحذوف.<syntaxhighlight lang="kotlin">
inline fun String.removeRange(range: IntRange): String
 
</syntaxhighlight>في حال استدعاء  الدالة <code>removeRange()‎</code> عبر [[Kotlin/String|سلسلة نصية]] مع تمرير مجال<code>range</code> من النوع <code>IntRange</code> كوسيط فستعيد [[Kotlin/String|سلسلة نصية]] جديدة مع حذف الحروف التي فهرسها ينتمي إلى المجال<code>range.</code> تذكر أنّ نهاية <code>range</code> مُتضمّنة في الجزء المحذوف.


==القيم المعادة==
==القيم المعادة==
سطر 15: سطر 24:
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()removeRange</code> مع سلسلة نصية===
===استخدام الدالة <code>()removeRange</code> مع سلسلة نصية===
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()removeRange</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()removeRange</code> عبرها مع تمرير  عددين كوسيطين، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val str = "hsoub wiki"  
val str = "hsoub wiki"  
      
      
print( str.removeSuffix ("wiki") ) // hsoub
println( str.removeRange (1,5) ) // h wiki  
print( str.removeSuffix ("xyz") ) // hsoub wiki
}
}
</syntaxhighlight>
</syntaxhighlight>
===انظر أيضًا===
===استخدام الدالة <code>()removeRange</code> مع سلسلة نصية مع تمرير مجال كوسيط===
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()removeRange</code> عبرها مع تمرير  مجال كوسيط، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
val str = "hsoub wiki"
   
println( str.removeRange (2..4) ) // hs wiki
}
</syntaxhighlight>
 
== انظر أيضًا ==
* <code>[[Kotlin/kotlin.text/removePrefix|removePrefix()]]‎</code>: إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removePrefix()‎</code> تبدأ بالبادئة <code>prefix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي. 
* <code>[[Kotlin/kotlin.text/removePrefix|removePrefix()]]‎</code>: إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removePrefix()‎</code> تبدأ بالبادئة <code>prefix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك البادئة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي. 


* <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
* <code>[[Kotlin/kotlin.text/removeSuffix|removeSuffix()]]‎</code>: إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSuffix()‎</code> تنتهي باللاحقة <code>suffix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك اللاحقة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي. 
* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.


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

مراجعة 19:14، 11 يوليو 2018

تعيد الدالة removeRange()‎ السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها مع حذف جزء منها (انظر فقرة البنيةالعامة).

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

fun CharSequence.removeRange(
    startIndex: Int, 
    endIndex: Int
): CharSequence

في حال استدعاء الدالة removeRange()‎ عبر سلسلة حروف مع تمرير عددين startIndex و endIndex كوسيطين فستعيد سلسلة حروف جديدة مع حذف الحروف التي فهرسها محصور بين startIndex و endIndex. تذكر أن endIndex ليس مُتضمّنا في الجزء المحذوف.

inline fun String.removeRange(
    startIndex: Int, 
    endIndex: Int
): String

في حال استدعاء الدالة removeRange()‎ عبر سلسلة نصية مع تمرير عددين startIndex و endIndex كوسيطين فستعيد سلسلة نصية جديدة مع حذف الحروف التي فهرسها محصور بين startIndex و endIndex. تذكّر أن endIndex ليس مُتضمّنا في الجزء المحذوف.

fun CharSequence.removeRange(range: IntRange): CharSequence

في حال استدعاء الدالة removeRange()‎ عبر سلسلة حروف مع تمرير مجالrange من النوع IntRange كوسيط فستعيد سلسلة حروف جديدة مع حذف الحروف التي فهرسها ينتمي إلى المجالrange. تذكر أنّ نهاية range مُتضمّنة في الجزء المحذوف.

inline fun String.removeRange(range: IntRange): String

في حال استدعاء الدالة removeRange()‎ عبر سلسلة نصية مع تمرير مجالrange من النوع IntRange كوسيط فستعيد سلسلة نصية جديدة مع حذف الحروف التي فهرسها ينتمي إلى المجالrange. تذكر أنّ نهاية range مُتضمّنة في الجزء المحذوف.

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

سلسلة نصية أو سلسلة الحروف.

أمثلة

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

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

fun main(args: Array<String>) {
val str = "hsoub wiki" 
    
println( str.removeRange (1,5) ) // h wiki 
}

استخدام الدالة ()removeRange مع سلسلة نصية مع تمرير مجال كوسيط

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

fun main(args: Array<String>) {
val str = "hsoub wiki" 
    
println( str.removeRange (2..4) ) // hs wiki
}

انظر أيضًا

مصادر