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

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
ط استبدال النص - 'Kotlin Functions' ب'Kotlin Function'
طلا ملخص تعديل
 
(2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.slice()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>slice()‎</code> في Kotlin}}</noinclude>
تعيد  الدالة <code>slice()‎</code> [[Kotlin/CharSequence/index|سلسلة حروف]] أو [[Kotlin/String|سلسلة نصية]] جديدة تحتوي الحروف التي تنتمي فهارسها إلى الوسيط المُمرر.  
<nowiki/>تقتطع الدالة <code>slice()‎</code> جزءًا محدَّدًا من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]]  التي استُدعيت معها ثمَّ تعيده.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
fun CharSequence.slice(indices: IntRange): CharSequence  
fun CharSequence.slice(indices: IntRange): CharSequence  


</syntaxhighlight>في حال استدعاء  الدالة <code>slice()‎</code> عبر [[Kotlin/CharSequence/index|سلسلة حروف]] مع تمرير مجال  <code>indices</code> من النوع <code>IntRange</code> كوسيط فستعيد  [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة تحتوي الحروف التي تنتمي فهارسها إلى <code>IntRange</code>.<syntaxhighlight lang="kotlin">
fun String.slice(indices: IntRange): String
fun String.slice(indices: IntRange): String  


</syntaxhighlight>في حال استدعاء  الدالة <code>slice()‎</code> عبر  [[Kotlin/String|سلسلة نصية]] مع تمرير مجال  <code>indices</code> من النوع <code>IntRange</code> كوسيط فستعيد  [[Kotlin/String|سلسلة نصية]] جديدة تحتوي الحروف التي تنتمي فهارسها إلى <code>IntRange</code>.<syntaxhighlight lang="kotlin">
fun CharSequence.slice(indices: Iterable<Int>): CharSequence
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">
inline fun CharSequence.replace(
    regex: Regex,
    noinline transform: (MatchResult) -> CharSequence
): String
</syntaxhighlight>في حال استدعاء  الدالة <code>slice()‎</code> عبر  [[Kotlin/String|سلسلة نصية]] مع تمرير مجال  <code>indices</code> من النوع <code>Iterable<Int>‎</code> كوسيط فستعيد  [[Kotlin/String|سلسلة نصية]] جديدة تحتوي الحروف التي تنتمي فهارسها إلى <code>IntRange</code>.
 
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].


inline fun String.slice(indices: Iterable<Int>): String
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
==المعاملات==
===<code>indices</code>===
مجال من النوع <code>[[Kotlin/ranges/IntRange|IntRange]]</code> أو كائن من النوع <code>[[Kotlin/collections/Iterable|Iterable]]</code> يحدد الجزء المراد اقتطاعه من [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة.
==القيم المعادة==
==القيم المعادة==
[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]].  
تعاد [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]] تحوي الجزء المقتطع من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة المحدد بالمعامل <code>indices</code> المعطى.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()replace</code> مع سلسلة نصية===
مثالٌ على استعمال الدالة <code>()replace</code>:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()replace</code> عبرها مع تمرير مجال كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
     val str = "Hsoub wiki"
     val str = "wikiHsoub"


     println(str.slice(0..4)) // Hsoub
     println(str.slice(0..4)) // wikiH
}
}
</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/split|split()‎]]</code>: تقتطع المحارف الموجودة بين الأجزاء المتطابقة مع <nowiki/>[[Kotlin/kotlin.text/Regex|تعبير نمطي]] معين أو بين سلاسل نصية أو محارف معينة في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها وتعيدها في قائمة. 
 
*الدالة <code>[[Kotlin/CharSequence/subSequence|subSequence()‎‎]]</code>: تجلب جزءًا محددًا يقع في <nowiki/>[[Kotlin/CharSequence|سلسلة الحروف]] التي استٌدعيت معها.
* <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/substring|substring()‎]]</code>: تعيد جزءًا محددًا من [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.  
* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.


* الدالة <code>[[Kotlin/kotlin.text/Regex/replace|replace()‎]]</code>: تبدل سلسلة النصية معينة مكان كل تطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي تعيدها الدالة الممررة إليها.
==مصادر==
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/slice.html الدالة text.slice()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/slice.html صفحة الدالة slice()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]

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

تقتطع الدالة slice()‎ جزءًا محدَّدًا من سلسلة المحارف أو السلسلة النصية  التي استُدعيت معها ثمَّ تعيده.

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

fun CharSequence.slice(indices: IntRange): CharSequence 

fun String.slice(indices: IntRange): String

fun CharSequence.slice(indices: Iterable<Int>): CharSequence

inline fun String.slice(indices: Iterable<Int>): String

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

المعاملات

indices

مجال من النوع IntRange أو كائن من النوع Iterable يحدد الجزء المراد اقتطاعه من سلسلة المحارف أو السلسلة النصية المعطاة.

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

تعاد سلسلة من المحارف أو سلسلة نصية تحوي الجزء المقتطع من سلسلة المحارف أو السلسلة النصية المعطاة المحدد بالمعامل indices المعطى.

أمثلة

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

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

    println(str.slice(0..4)) // wikiH
}

انظر أيضًا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/slice&oldid=16673»