الفرق بين المراجعتين ل"Kotlin/kotlin.text/subSequence"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - 'Kotlin Functions' ب'Kotlin Function') |
جميل-بيلوني (نقاش | مساهمات) (مراجعة وتدقيق.) |
||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: الدالة <code> | + | <noinclude>{{DISPLAYTITLE: الدالة <code>subSequence()</code> في Kotlin}}</noinclude> |
| − | تعيد | + | تعيد الدالة <code>subSequence()</code> جزءًا محددًا من [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها. |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
fun CharSequence.subSequence(range: IntRange): CharSequence | fun CharSequence.subSequence(range: IntRange): CharSequence | ||
| − | </syntaxhighlight> | + | </syntaxhighlight><syntaxhighlight lang="kotlin"> |
| + | inline fun String.subSequence( | ||
| + | start: Int, | ||
| + | end: Int | ||
| + | ): CharSequence | ||
| + | </syntaxhighlight>هذا الشكل من الدالة قد '''أُهمِل'''. | ||
| + | |||
| + | == المعاملات == | ||
| + | |||
| + | === <code>range</code> === | ||
| + | مجال من النوع <code>[[Kotlin/ranges/IntRange|IntRange]]</code> يحدد الجزء المراد جلبه من [[Kotlin/CharSequence/index|سلسلة المحارف]] المعطاة. | ||
| + | |||
| + | === <code>start</code> === | ||
| + | عدد صحيح يشير إلى فهرس العنصر الذي يمثل بداية المجال المراد جلبه. | ||
| + | |||
| + | === <code>end</code> === | ||
| + | عدد صحيح يشير إلى فهرس العنصر الذي يمثل نهاية المجال المراد جلبه. | ||
| + | |||
==القيم المعادة== | ==القيم المعادة== | ||
| − | [[Kotlin/CharSequence/index|سلسلة | + | تعاد [[Kotlin/CharSequence/index|سلسلة من المحارف]] التي تحوي الجزء المقتطع من سلسلة المحارف المعطاة المحدد بالمجال <code>range</code>. |
==أمثلة== | ==أمثلة== | ||
| − | + | مثالٌ على استعمال الدالة <code>()subSequence</code><nowiki/><nowiki/>:<syntaxhighlight lang="kotlin"> | |
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | val str = "wiki.hsoub.com" | + | val str = "wiki.hsoub.com" |
| − | + | ||
| − | println(str.subSequence(5..9)) // hsoub | + | println(str.subSequence(5..9)) // hsoub |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| + | * الدالة <code>[[Kotlin/CharSequence/subSequence|subSequence()]]</code>: تجلب جزءًا محددًا يقع في <nowiki/>[[Kotlin/CharSequence|سلسلة الحروف]] التي استٌدعيت معها. | ||
* <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|السلسلة النصية]] الأصلية. | ||
| سطر 25: | سطر 42: | ||
==مصادر== | ==مصادر== | ||
| − | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/sub-sequence.html الدالة | + | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/sub-sequence.html صفحة الدالة subSequence() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Function]] | [[تصنيف:Kotlin Function]] | ||
| + | [[تصنيف:Kotlin Text]] | ||
مراجعة 14:33، 5 سبتمبر 2018
تعيد الدالة subSequence() جزءًا محددًا من سلسلة المحارف التي استُدعيت معها.
البنية العامة
fun CharSequence.subSequence(range: IntRange): CharSequence
inline fun String.subSequence(
start: Int,
end: Int
): CharSequence
هذا الشكل من الدالة قد أُهمِل.
المعاملات
range
مجال من النوع IntRange يحدد الجزء المراد جلبه من سلسلة المحارف المعطاة.
start
عدد صحيح يشير إلى فهرس العنصر الذي يمثل بداية المجال المراد جلبه.
end
عدد صحيح يشير إلى فهرس العنصر الذي يمثل نهاية المجال المراد جلبه.
القيم المعادة
تعاد سلسلة من المحارف التي تحوي الجزء المقتطع من سلسلة المحارف المعطاة المحدد بالمجال range.
أمثلة
مثالٌ على استعمال الدالة ()subSequence:
fun main(args: Array<String>) {
val str = "wiki.hsoub.com"
println(str.subSequence(5..9)) // hsoub
}
انظر أيضًا
- الدالة
subSequence(): تجلب جزءًا محددًا يقع في سلسلة الحروف التي استٌدعيت معها. replaceAfter(): تعيد الدالةreplaceAfter()سلسلة نصية جديدة تساوي السلسلة النصية التي استُدعيت عبرها مع تعويض الجزء الذي يظهر بعد الوسيط المُمرّرdelimiterبالسلسلة النصيةreplacement. إن لم لم تحتو السلسلة النصية علىdelimiterفستعيدmissingDelimiterValueوالذي يساوي افتراضيا السلسلة النصية الأصلية.
removeSuffix(): إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالةremoveSuffix()تنتهي باللاحقةsuffixفستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك اللاحقة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.slice(): تعيد الدالةslice()سلسلة حروف أو سلسلة نصية جديدة تحتوي الحروف التي تنتمي فهارسها إلى الوسيط المُمرر.