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

المراجعة الحالية بتاريخ 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
}

انظر أيضًا

الدالة removePrefix()‎: تحذف بادئة معينة من سلسلة من المحارف أو سلسلة نصية.

الدالة removeSuffix()‎: تحذف لاحقة معينة من سلسلة من المحارف أو سلسلة نصية.
الدالة removeSurrounding()‎: تحذف بادئة ولاحقة محددتين من سلسلة من المحارف أو سلسلة نصية.

مصادر

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

@@ سطر 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">
@@ سطر 7: / سطر 7: @@
      endIndex: Int
 ): 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(
      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>في حال استدعاء  الدالة <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> مُتضمّنة في الجزء المحذوف.
+</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>) {
-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>
 == انظر أيضًا ==
-* <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 Function]]
+[[تصنيف:Kotlin Text]]