الفرق بين المراجعتين ل"Kotlin/kotlin.text/buildString"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - 'Kotlin Functions' ب'Kotlin Function') |
|||
سطر 33: | سطر 33: | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/build-string.html الدالة text.buildString() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/build-string.html الدالة text.buildString() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
− | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
مراجعة 11:32، 30 أغسطس 2018
تبني الدالة 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
والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.