الفرق بين المراجعتين ل"Kotlin/kotlin.text/removeRange"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (استبدال النص - 'Kotlin Functions' ب'Kotlin Function')
(مراجعة وتدقيق.)
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.removeRange()‎</code> في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>removeRange()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>removeRange()‎</code> [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها مع حذف جزء منها (انظر فقرة [[Kotlin/kotlin.text/removeRange#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنيةالعامة]]).  
+
تحذف الدالة <code>removeRange()‎</code> مجالًا محددًا من [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها.  
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
سطر 7: سطر 7:
 
     endIndex: Int
 
     endIndex: Int
 
): CharSequence
 
): CharSequence
</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">
+
 
 
inline fun String.removeRange(
 
inline fun String.removeRange(
 
     startIndex: Int,  
 
     startIndex: Int,  
 
     endIndex: Int
 
     endIndex: Int
 
): String
 
): 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  
 
fun CharSequence.removeRange(range: IntRange): CharSequence  
  
</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  
 
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> مُتضمّنة في الجزء المحذوف.
+
</syntaxhighlight>
 +
 
 +
== المعاملات ==
 +
 
 +
=== <code>startIndex</code> ===
 +
[[Kotlin/Int|عدد صحيح]] يشير إلى فهرس المحرف الذي يمثل بداية الجزء المراد حذفه.
 +
 
 +
=== <code>endIndex</code> ===
 +
[[Kotlin/Int|عدد صحيح]] يشير إلى فهرس المحرف الذي يمثل نهاية الجزء المراد حذفه (لا يدخل هذا المحرف ضمن المجال المحذوف).
 +
 
 +
=== <code>range</code> ===
 +
مجال من النوع <code>[[Kotlin/ranges/IntRange|Intrange]]</code> يمثل المجال المراد حذفه؛ أي يحدد بداية ونهاية الجزء المراد حذفه.
  
 
==القيم المعادة==
 
==القيم المعادة==
[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]].  
+
تعاد [[Kotlin/CharSequence/index|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]] جديدة تحوي جميع محارف [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة باستثناء المحارف الواقعة بين المحرف ذي الفهرس <code>startIndex</code> والمحرف ذي الفهرس <code>endIndex</code>، أو الواقعة في المجال <code>range</code>.  
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة <code>()removeRange</code> مع سلسلة نصية===
+
مثالٌ على استعمال الدالة <code>()removeRange</code><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 = "wikiHsoub"
      
+
 
println( str.removeRange (1,5) ) // h wiki
+
     println(str.removeRange(1, 5)) // wsoub
}
+
     println(str.removeRange(1..5)) // woub
</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>
 
</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/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]].
  
* <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/removeSuffix|removeSuffix()]]‎</code>: تحذف لاحقة معينة من [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]]. 
* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
+
* الدالة <code>[[Kotlin/kotlin.text/removeSurrounding|removeSurrounding()]]</code>: تحذف بادئة ولاحقة محددتين من [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]].  
  
 
==مصادر==
 
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/remove-range.html الدالة text.removeRange()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/remove-range.html صفحة الدالة removeRange()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Function]]
 
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]

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

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

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

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

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

fun CharSequence.removeRange(range: IntRange): CharSequence 

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

المعاملات

startIndex

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

endIndex

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

range

مجال من النوع Intrange يمثل المجال المراد حذفه؛ أي يحدد بداية ونهاية الجزء المراد حذفه.

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

تعاد سلسلة من المحارف أو سلسلة نصية جديدة تحوي جميع محارف سلسلة المحارف أو السلسلة النصية المعطاة باستثناء المحارف الواقعة بين المحرف ذي الفهرس startIndex والمحرف ذي الفهرس endIndex، أو الواقعة في المجال range.

أمثلة

مثالٌ على استعمال الدالة ()removeRange:

fun main(args: Array<String>) {
    val str = "wikiHsoub"

    println(str.removeRange(1, 5)) // wsoub
    println(str.removeRange(1..5)) // woub
}

انظر أيضًا

مصادر