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
}

انظر أيضًا

• الدالة toString()‎: تحول الكائن StringBuilder إلى سلسلة نصية.
• الدالة subSequence()‎: تقتطع جزءًا محددًا من سلسلة محارف الكائن StringBuilder وتعيدها.
• الدالة get()‎: تجلب محرفًا ذا فهرس محدَّدٍ من سلسلة محارف الكائن StringBuilder.
• الدالة reverse()‎: تعكس ترتيب محارف الكائن StringBuilder.

مصادر

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