الدالة CharSequence.repeat()‎ في Kotlin

تكرِّر الدالة repeat()‎ سلسلة المحارف التي استٌدعيت معها عددًا محددًا من المرات.

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

actual fun CharSequence.repeat(n: Int): String

المعاملات

n

عدد صحيح يمثل عدد مرات تكرار سلسلة المحارف المعطاة. إن أعطيت قيمة سالبة لهذا المعامل، فسيُطلَق الاستثناء IllegalArgumentException.

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

تعاد سلسلة من المحارف تحوي جميع محارف السلسلة المعطاة بعد تكرارها n مرة.

أمثلة

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

fun main(args: Array<String>) {
    println("Word".repeat(4)) // WordWordWordWord
    println("Word".repeat(0)) //
}

مثالٌ آخر على استعمال الدالة ()repeat مع تمرير عدد سالب للمعامل n:

fun main(args: Array<String>) {
    println("Word".repeat(-4))
}

ناتج تنفيذ هذا المثال هو:

Exception in thread "main" java.lang.IllegalArgumentException: Count 'n' must be non-negative, but was -4.
	at kotlin.text.StringsKt__StringsJVMKt.repeat(StringsJVM.kt:436)
	at TestKt.main(test.kt:2)

انظر أيضًا

• الدالة replace()‎: تبدل محرفًا جديدًا مكان محرف قديم، أو سلسلة نصية جديدة مكان سلسلة نصية قديمة، أو سلسلة نصية جديدة أو ناتج تنفيذ دالة مكان كل ما يطابق تعبير نمطي معين في سلسلة نصية أو سلسلة من المحارف.
• الدالة padEnd()‎: تحشو نهاية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.
• الدالة removeSurrounding()‎: تحذف بادئة ولاحقة محددتين من سلسلة من المحارف أو سلسلة نصية.  

مصادر

• صفحة الدالة CharSequence.repeat()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.