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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.substring()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>substring()‎</code> Kotlin/Cha...')
 
ط
 
(6 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
−
<noinclude>{{DISPLAYTITLE: الدالة <code>text.substring()‎</code> في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>substring()‎</code> في Kotlin}}</noinclude>
−
تعيد الدالة <code>substring()‎</code> [[Kotlin/CharSequence/index|سلسلة حروف]] أو [[Kotlin/String|سلسلة نصية]] جديدة تحتوي الحروف التي تنتمي فهارسها إلى الوسيط المُمرر.  
+
تعيد الدالة <code>substring()‎</code> جزءًا محددًا من [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
−
fun CharSequence.slice(indices: IntRange): CharSequence
+
inline actual fun String.substring(startIndex: Int): String
  
−
</syntaxhighlight>في حال استدعاء  الدالة <code>substring()‎</code> عبر [[Kotlin/CharSequence/index|سلسلة حروف]] مع تمرير مجال  <code>indices</code> من النوع <code>IntRange</code> كوسيط فستعيد  [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة تحتوي الحروف التي تنتمي فهارسها إلى <code>IntRange</code>.<syntaxhighlight lang="kotlin">
+
inline actual fun String.substring(
−
fun String.slice(indices: IntRange): String  
+
    startIndex: Int,
 +
    endIndex: Int
 +
): String
  
−
</syntaxhighlight>في حال استدعاء  الدالة <code>slice()‎</code> عبر  [[Kotlin/String|سلسلة نصية]] مع تمرير مجال  <code>indices</code> من النوع <code>IntRange</code> كوسيط فستعيد  [[Kotlin/String|سلسلة نصية]] جديدة تحتوي الحروف التي تنتمي فهارسها إلى <code>IntRange</code>.<syntaxhighlight lang="kotlin">
+
fun String.substring(range: IntRange): String
−
fun CharSequence.slice(indices: Iterable<Int>): CharSequence
 
  
−
</syntaxhighlight>في حال استدعاء  الدالة <code>slice()‎</code> عبر [[Kotlin/CharSequence/index|سلسلة حروف]] مع تمرير مجال  <code>indices</code> من النوع <code>Iterable<Int>‎</code> كوسيط فستعيد  [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة تحتوي الحروف التي تنتمي فهارسها إلى <code>IntRange</code>.<nowiki/><syntaxhighlight lang="kotlin">
+
fun CharSequence.substring(range: IntRange): String
−
inline fun CharSequence.replace(
+
 
−
     regex: Regex,  
+
inline fun CharSequence.substring(
−
     noinline transform: (MatchResult) -> CharSequence
+
     startIndex: Int,  
 +
     endIndex: Int = length
 
): String
 
): String
−
</syntaxhighlight>في حال استدعاء  الدالة <code>slice()‎</code> عبر  [[Kotlin/String|سلسلة نصية]] مع تمرير مجال  <code>indices</code> من النوع <code>Iterable<Int>‎</code> كوسيط فستعيد  [[Kotlin/String|سلسلة نصية]] جديدة تحتوي الحروف التي تنتمي فهارسها إلى <code>IntRange</code>.
+
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
 +
 
 +
== المعاملات ==
 +
 
 +
=== <code>startIndex</code> ===
 +
عدد صحيح يشير إلى فهرس العنصر الذي يمثل بداية المجال المراد جلبه.
  
−
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+
=== <code>endIndex</code> ===
 +
عدد صحيح يشير إلى فهرس العنصر الذي يمثل نهاية المجال المراد جلبه (لا يدخل هذا المحرف ضمن المجال). إن لم يعطَ هذا المعامل، فستكون نهاية الجزء المراد جلبه هي نهاية سلسلة المحارف أو السلسلة النصية المعطاة.
 +
 
 +
=== <code>range</code> ===
 +
مجال من النوع <code>[[Kotlin/ranges/IntRange|IntRange]]</code> يحدد الجزء المراد جلبه من [[Kotlin/CharSequence/index|سلسلة المحارف]] المعطاة.
  
 
==القيم المعادة==
 
==القيم المعادة==
−
[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]].  
+
تعاد [[Kotlin/String|سلسلة نصية]] تحوي الجزء المقتطع من سلسلة المحارف المعطاة المحدد بالمعامل <code>startIndex</code> والمعامل <code>endIndex</code>، أو بالمجال <code>range</code>. 
 
==أمثلة==
 
==أمثلة==
−
===استخدام الدالة <code>()substring</code> مع سلسلة نصية===
+
مثالٌ على استعمال الدالة <code>()substring</code><nowiki/>:<syntaxhighlight lang="kotlin">
−
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()substring</code> عبرها مع تمرير مجال كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
−
     val str = "Hsoub wiki"
+
     val str = "wiki.hsoub.com"
  
−
     println(str.slice(0..4)) // Hsoub
+
     println(str.substring(5..9)) // hsoub
 +
    println(str.substring(5, 10)) // hsoub
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
−
* <code>[[Kotlin/kotlin.text/replaceAfter|replaceAfter()]]‎</code>: تعيد الدالة <code>replaceAfter()‎</code> [[Kotlin/String|سلسلة نصية]] جديدة تساوي [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها مع تعويض الجزء الذي يظهر بعد الوسيط المُمرّر <code>delimiter</code> [[Kotlin/String|بالسلسلة النصية]] <code>replacement</code>. إن لم لم تحتو  [[Kotlin/String|السلسلة النصية]] على <code>delimiter</code> فستعيد <code>missingDelimiterValue</code> والذي يساوي افتراضيا [[Kotlin/String|السلسلة النصية]] الأصلية. 
+
* الدالة <code>[[Kotlin/kotlin.text/subSequence|subSequence()‎]]</code> : تعيد جزءًا محددًا من [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
−
 
+
* الدالة <code>[[Kotlin/kotlin.text/substringAfter|substringAfter()]]‎</code>: تجلب كل الجزء الواقع بعد أول ظهور <nowiki/>[[Kotlin/Char|لمحرف]] أو لسلسلة نصية معينة في سلسلة نصية.
−
* <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/substringBefore|substringBefore()]]‎</code>: تجلب كل الجزء الواقع قبل أول ظهور <nowiki/>[[Kotlin/Char|لمحرف]] أو لسلسلة نصية معينة في سلسلة نصية. .  
−
* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
+
* الدالة <code>[[Kotlin/kotlin.text/slice|slice()]]‎</code>: تقتطع جزءًا محدَّدًا من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]]  التي استُدعيت معها ثمَّ تعيده.
 +
* الدالة <code>[[Kotlin/kotlin.text/replace|replace()‎]]</code>: تبدل محرفًا جديدًا مكان محرف قديم، أو سلسلة نصية جديدة مكان سلسلة نصية قديمة، أو سلسلة نصية جديدة أو ناتج تنفيذ دالة مكان كل ما يطابق تعبير نمطي معين في سلسلة نصية أو سلسلة من المحارف.
  
 
==مصادر==
 
==مصادر==
−
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/slice.html الدالة text.substring()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/substring.html صفحة الدالة substring()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
−
[[تصنيف:Kotlin Functions]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]

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

تعيد الدالة substring()‎ جزءًا محددًا من السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.

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

inline actual fun String.substring(startIndex: Int): String 

inline actual fun String.substring(
    startIndex: Int, 
    endIndex: Int
): String

fun String.substring(range: IntRange): String 

fun CharSequence.substring(range: IntRange): String

inline fun CharSequence.substring(
    startIndex: Int, 
    endIndex: Int = length
): String

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).

المعاملات

startIndex

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

endIndex

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

range

مجال من النوع IntRange يحدد الجزء المراد جلبه من سلسلة المحارف المعطاة.

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

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

أمثلة

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

fun main(args: Array<String>) {
    val str = "wiki.hsoub.com"

    println(str.substring(5..9)) // hsoub
    println(str.substring(5, 10)) // hsoub
}

انظر أيضًا

  • الدالة subSequence()‎ : تعيد جزءًا محددًا من سلسلة المحارف التي استُدعيت معها.
  • الدالة substringAfter()‎: تجلب كل الجزء الواقع بعد أول ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية.
  • الدالة substringBefore()‎: تجلب كل الجزء الواقع قبل أول ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية. .  
  • الدالة slice()‎: تقتطع جزءًا محدَّدًا من سلسلة المحارف أو السلسلة النصية  التي استُدعيت معها ثمَّ تعيده.
  • الدالة replace()‎: تبدل محرفًا جديدًا مكان محرف قديم، أو سلسلة نصية جديدة مكان سلسلة نصية قديمة، أو سلسلة نصية جديدة أو ناتج تنفيذ دالة مكان كل ما يطابق تعبير نمطي معين في سلسلة نصية أو سلسلة من المحارف.

مصادر

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