Kotlin/kotlin.text/buildString

تبني الدالة buildString()‎ سلسلة نصية عبر ملأ الكائن من نوع StringBuilder المُنشأ حديثَا باستخدام الدالة المُمرّرة builderAction‎ ثم تُحولها إلى سلسلة نصية. في حال تمرير وسيط capacity من نوع Int فإنّ الكائن StringBuilder سيأخذ قيمه الابتدائية انطلاقا منcapacity.

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

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

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

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

سلسلة نصية.

أمثلة

استخدام الدالة ()buildString

تعرِّف الشيفرة الآتية سلسلة نصية باسم x عبر الدالة ()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, 
}

انظر أيضًا

• associateBy()‎: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة keySelector.

• associateByTo()‎: تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة keySelector. 
• asSequence()‎: تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

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