Kotlin/kotlin.text/StringBuilder/append

تضيف الدالة append()‎ محرفًا أو سلسلة نصية أو أيَّ كائن آخر إلى الكائن StringBuilder.

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

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.

حلت الدالة Appendable.append مكان هذه الدالة.

المعاملات

c

محرفٌ يراد إضافته إلى الكائن StringBuilder.

csq

سلسلة من المحارف التي يراد إضافتها بأكملها أو جزء محدد منها إلى الكائن StringBuilder.

start

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

end

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

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

يعاد الكائن StringBuilder المعطى نفسه بعد إضافة المحرف c أو سلسلة المحارف csq إليه.

أمثلة

استعمال الدالة append()‎ لإضافة سلسلة من المحارف إلى كائن من النوع StringBuilder:

fun main(args: Array<String>) {
    val sb = StringBuilder("Hsoub")
    val str = sb.append("Academy", 2, 5)

    println(str) // => Hsoubade
}

انظر أيضًا

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

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

مصادر

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