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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.removeRange()‎</code> في لغة Kotlin}}</noinclude> إن كانت السلسلة النصية...')
 
(مراجعة وتدقيق.)
 
(3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
−
<noinclude>{{DISPLAYTITLE: الدالة <code>text.removeRange()‎</code> في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>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/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها.  
 
==البنية العامة==
 
==البنية العامة==
 
<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">
 
−
fun String.removePrefix(prefix: CharSequence): String
 
  
−
</syntaxhighlight>إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها الدالة <code>removeRange()‎</code>تنتهي باللاحقة <code>suffix</code> فستعيد [[Kotlin/String|سلسلة نصية]] جديدة مع حذف تلك اللاحقة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]]  كما هي.
+
inline fun String.removeRange(
 +
    startIndex: Int,
 +
    endIndex: Int
 +
): String
 +
 
 +
fun CharSequence.removeRange(range: IntRange): CharSequence
 +
 
 +
inline fun String.removeRange(range: IntRange): String
 +
 
 +
</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> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
−
val str = "hsoub wiki"  
+
    val str = "wikiHsoub"
−
      
+
 
−
print( str.removeSuffix ("wiki") ) // hsoub
+
     println(str.removeRange(1, 5)) // wsoub
−
print( str.removeSuffix ("xyz") ) // hsoub wiki
+
    println(str.removeRange(1..5)) // woub
 
}
 
}
 
</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/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
+
* الدالة <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-suffix.html الدالة text.removeRange()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/remove-range.html صفحة الدالة removeRange()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
−
[[تصنيف:Kotlin Functions]]
+
[[تصنيف: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
}

انظر أيضًا

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/removeRange&oldid=16550"