الدالة Appendable.append()‎ في Kotlin

تضيف الدالة append()‎ المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها.

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

abstract actual fun append(csq: CharSequence?): Appendable 

abstract actual fun append(
    csq: CharSequence?, 
    start: Int, 
    end: Int
): Appendable 

abstract actual fun append(c: Char): Appendable

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

المعاملات

csq

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

start

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

end

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

c

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

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

يعاد الكائن Appendable المعطى بعد إضافة محتوى الكائن الممرر إليه.

أمثلة

يوضح المثال التالي كيفية إنشاء كائن من النوع Appendable باستخدام الدالة StringBuilder()‎، واستعمال الدالة append()‎ لإضافة محتوى سلسلتين نصيتين إليه:

fun main(args: Array<String>) {
    val str1 = "hsoub"
    val str2 = "Academy"
    val str = StringBuilder()

    str.append(str1).append(str2)

    print(str) // hsoubAcademy
}

انظر أيضًا

• الصنف Appendable.

مصادر

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