الدالة buildString()‎ في Kotlin

تنشئ الدالة buildString()‎ سلسلة نصية جديدة عبر ملئها بالكائن StringBuilder المُنشأ حديثًا ثم تحويله إلى سلسلة نصية.

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

inline fun buildString(
    builderAction: StringBuilder.() -> Unit
): String (source)

inline fun buildString(
    capacity: Int, 
    builderAction: StringBuilder.() -> Unit
): String

الإصدار المطلوب: Kotlin 1.1.

وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions)).

المعاملات

capacity

عددٌ صحيحٌ. إن إن أعطي هذا المعامل capacity، فإنّ الكائن StringBuilder سيأخذ قيمه الابتدائية انطلاقًا من capacity.

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

تعاد سلسلة نصية.

أمثلة

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

val x = buildString {
    append("Lucky numbers: ")
    for (i in 1..10) {
        append("${(Math.random() * 100).toInt()}, ")
    }
}

fun main(args: Array<String>) {
    println(x) // Lucky numbers: 12, 60, 56, 27, 30, 50, 26, 72, 70, 27,
}

انظر أيضًا

• الدالة StringBuilder()‎: تنشئ كائنًا من النوع StringBuilder.

مصادر

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