الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/slice»
< Kotlin | kotlin.text
ط استبدال النص - 'Kotlin Functions' ب'Kotlin Function' |
جميل-بيلوني (نقاش | مساهمات) مراجعة وتدقيق. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code> | <noinclude>{{DISPLAYTITLE: الدالة <code>slice()</code> في Kotlin}}</noinclude> | ||
تقطتع الدالة <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 | ||
fun String.slice(indices: IntRange): String | |||
fun String.slice(indices: IntRange): String | |||
fun CharSequence.slice(indices: Iterable<Int>): CharSequence | |||
fun CharSequence.slice(indices: Iterable<Int>): CharSequence | |||
inline fun String.slice(indices: Iterable<Int>): String | |||
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). | |||
): String | |||
</syntaxhighlight> | |||
== المعاملات == | |||
=== <code>indices</code> === | |||
مجال من النوع <code>[[Kotlin/ranges/IntRange|IntRange]]</code> أو كائن من النوع <code>[[Kotlin/collections/Iterable|Iterable]]</code> يحدد الجزء المراد اقتطاعه من [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة. | |||
==القيم المعادة== | ==القيم المعادة== | ||
[[Kotlin/String|سلسلة نصية]] | تعاد [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]] تحوي الجزء المقتطع من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة المحدد بالمعامل <code>indices</code> المعطى. | ||
==أمثلة== | ==أمثلة== | ||
مثالٌ على استعمال الدالة <code>()replace</code>:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val str = " | val str = "wikiHsoub" | ||
println(str.slice(0..4)) // | 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/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/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/asSequence|asSequence()]]</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية. | |||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/slice.html الدالة | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/slice.html صفحة الدالة slice() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Function]] | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Text]] | |||
مراجعة 11:57، 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
}
انظر أيضًا
replaceAfter(): تعيد الدالةreplaceAfter()سلسلة نصية جديدة تساوي السلسلة النصية التي استُدعيت عبرها مع تعويض الجزء الذي يظهر بعد الوسيط المُمرّرdelimiterبالسلسلة النصيةreplacement. إن لم لم تحتو السلسلة النصية علىdelimiterفستعيدmissingDelimiterValueوالذي يساوي افتراضيا السلسلة النصية الأصلية.
removeSuffix(): إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالةremoveSuffix()تنتهي باللاحقةsuffixفستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك اللاحقة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.asSequence(): تنشئ كائنًا من الصنفSequenceوالذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.