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

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
ط استبدال النص - '==القيمة المُعادة==' ب'==القيمة المعادة=='
مراجعة وتدقيق.
 
(مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>StringBuilder.subSequence()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>StringBuilder.subSequence()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>subSequence()‎</code> [[Kotlin/CharSequence/index|سلسلة حروف]] تحتوي جزءًا من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية بالفهرس المحدّد بالوسيط <code>startIndex</code> وانتهاءً  بالفهرس المحدّد بالوسيط <code>endIndex</code> (غير مُتضمّن).
تقتطع الدالة <code>subSequence()‎</code> جزءًا محددًا من سلسلة محارف الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]] وتعيدها.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
سطر 7: سطر 7:
     endIndex: Int
     endIndex: Int
): CharSequence
): CharSequence
</syntaxhighlight>
</syntaxhighlight>'''منصة التشغيل المطلوبة''': JS.
 
حلت الدالة <code>[[Kotlin/CharSequence/subSequence|CharSequence.subSequence]]</code> مكان هذه الدالة.
 
==المعاملات==
 
=== <code>startIndex</code> ===
[[Kotlin/Int|عدد صحيح]] يحدد فهرس المحرف الذي يمثل بداية الجزء المراد اقتطاعه من محتوى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]].
 
=== <code>endIndex</code> ===
[[Kotlin/Int|عدد صحيح]] يحدد فهرس المحرف (لا يدخل ضمن المجال) الذي يمثل نهاية الجزء المراد اقتطاعه من محتوى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]].
 
==القيمة المعادة==
==القيمة المعادة==
[[Kotlin/CharSequence/index|سلسلة حروف]].
تعاد [[Kotlin/CharSequence/index|سلسلة محارف]] تحتوي على الجزء المقتطع من الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]] والمحدد بالمحرف ذي الفهرس <code>startIndex</code> والمحرف ذي الفهرس <code>EndIndex</code> (لا يدخل هذا المحرف ضمن المجال).
==أمثلة==
==أمثلة==
===استخدام الدالة <code>subSequence()‎</code>===
استعمال الدالة <code>subSequence()‎</code> لاقتطاع جزء محدد من محتوى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]]:<nowiki/><syntaxhighlight lang="kotlin">
تُنشِئ الشيفرة الآتية كائنًا من النوع <code>StringBuilder</code>باسم <code>sb</code>، ثم تستدعي  الدالة<code>subSequence()‎</code> عبر  <code>sb</code>، وتمرر إليها عددين، ثم تطبع الناتج:<nowiki/><syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
     val sb = StringBuilder("Academy")
     val sb = StringBuilder("Academy")
سطر 19: سطر 29:
}
}
</syntaxhighlight>
</syntaxhighlight>
==أنظر أيضًا==
==انظر أيضًا==
* الخاصية <code>[[Kotlin/kotlin.text/StringBuilder/length|length]]:</code>تعيد عدد عناصر سلسلة الحروف التي استٌدعيت عبرها.
*الدالة <code>[[Kotlin/kotlin.text/StringBuilder/append|append()‎]]</code>: تضيف محرفًا أو [[Kotlin/String|سلسلة نصية]] أو أيَّ كائن آخر إلى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]].
* <code>[[Kotlin/kotlin.text/StringBuilder/append|append()‎]]</code>: تضم  [[Kotlin/String|السلسلة النصية]] أو الحرف أو الكائن المُمرّر إليها إلى الكائن الذي استُدعيت عبره، وفي حال تمرير  عددين <code>start</code> و  <code>end</code> كوسيطين، فإنها تضم فقط جزء من  [[Kotlin/String|السلسلة النصية]] المحدد بذانك الوسيطين.
*الدالة <code>[[Kotlin/kotlin.text/StringBuilder/toString|toString()‎]]</code>: تحول الكائن <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code> إلى [[Kotlin/String|سلسلة نصية]].
 
*الدالة <code>[[Kotlin/kotlin.text/StringBuilder/get|get()‎]]</code>: تجلب محرفًا ذا فهرس محدَّدٍ من [[Kotlin/CharSequence/index|سلسلة محارف]] الكائن <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code>.
* <code>[[Kotlin/kotlin.text/StringBuilder/get|get()‎]]</code>: تعيد الحرف الموجود عند الفهرس المُمرّر <code>index</code> في سلسلة الحروف التي استُدعيت عبرها.
*الدالة <code>[[Kotlin/kotlin.text/StringBuilder/reverse|reverse()‎]]</code>: تعكس ترتيب محارف الكائن [[Kotlin/kotlin.text/StringBuilder/index|<code>StringBuilder</code>]].
 
* صفحة الصنف <code>[[Kotlin/kotlin.text/StringBuilder/index|StringBuilder]]</code>.
 
==مصادر==
==مصادر==
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-string-builder/-string-builder/sub-sequence.html الدالة  StringBuilder.subSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-string-builder/-string-builder/sub-sequence.html صفحة الدالة StringBuilder.subSequence()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin StringBuilder]]

المراجعة الحالية بتاريخ 10:31، 1 سبتمبر 2018

تقتطع الدالة subSequence()‎ جزءًا محددًا من سلسلة محارف الكائن StringBuilder وتعيدها.

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

actual fun subSequence(
    startIndex: Int, 
    endIndex: Int
): CharSequence

منصة التشغيل المطلوبة: JS.

حلت الدالة CharSequence.subSequence مكان هذه الدالة.

المعاملات

startIndex

عدد صحيح يحدد فهرس المحرف الذي يمثل بداية الجزء المراد اقتطاعه من محتوى الكائن StringBuilder.

endIndex

عدد صحيح يحدد فهرس المحرف (لا يدخل ضمن المجال) الذي يمثل نهاية الجزء المراد اقتطاعه من محتوى الكائن StringBuilder.

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

تعاد سلسلة محارف تحتوي على الجزء المقتطع من الكائن StringBuilder والمحدد بالمحرف ذي الفهرس startIndex والمحرف ذي الفهرس EndIndex (لا يدخل هذا المحرف ضمن المجال).

أمثلة

استعمال الدالة subSequence()‎ لاقتطاع جزء محدد من محتوى الكائن StringBuilder:

fun main(args: Array<String>) {
    val sb = StringBuilder("Academy")
    
    println(sb.subSequence(2,5)) // => ade
}

انظر أيضًا

مصادر

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