Kotlin/kotlin.text/StringBuilder/append

تضم الدالةappend()‎ السلسلة النصية أو الحرف أو الكائن المُمرّر إليها إلى الكائن الذي استُدعيت عبره، وفي حال تمرير عددين start و  end كوسيطين، فإنها تضم فقط جزء من السلسلة النصية المحدد بذانك الوسيطين.

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

actual fun append(c: Char): StringBuilder 
actual fun append(csq: CharSequence?): StringBuilder 
actual fun append(
    csq: CharSequence?, 
    start: Int, 
    end: Int
): StringBuilder 
actual fun append(obj: Any?): StringBuilder

بيئة التشغيل المطلوبة: JS

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

كائن من النوع StringBuilder

أمثلة

استخدام التابع append()‎

تُنشِئ الشيفرة الآتية كائنًا من النوع StringBuilderباسم sb، و سلسلة نصية باسم str، ثم تستدعي  الدالةappend()‎ عبره  sb وتمرر إليها السلسلة النصية str، ثم تطبع الناتج:

fun main(args: Array<String>) {
    val str = " academy"
    val sb = StringBuilder("hsoub")
    
    println(sb.append(str)) // => hsoub academy
}

أنظر أيضًا

• الخاصية length:تعيد عدد عناصر سلسلة الحروف التي استٌدعيت عبرها.
• get()‎: تعيد الحرف الموجود عند الفهرس المُمرّر index في سلسلة الحروف التي استُدعيت عبرها.

• صفحة الصنف StringBuilder.

مصادر

• الدالة  StringBuilder.append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.