الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/buildString»
< Kotlin | kotlin.text
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) مراجعة وتدقيق. |
||
| (3 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code> | <noinclude>{{DISPLAYTITLE: الدالة <code>buildString()</code> في Kotlin}}</noinclude> | ||
تنشئ الدالة <code>buildString()</code> [[Kotlin/String|سلسلة نصية]] جديدة عبر ملئها بالكائن <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code> المُنشأ حديثًا ثم تحويله إلى [[Kotlin/String|سلسلة نصية]]. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
inline fun buildString( | |||
builderAction: StringBuilder.() -> Unit | |||
): String (source) | |||
</syntaxhighlight><syntaxhighlight lang="kotlin"> | |||
inline fun buildString( | inline fun buildString( | ||
capacity: Int, | capacity: Int, | ||
builderAction: StringBuilder.() -> Unit | builderAction: StringBuilder.() -> Unit | ||
): String | ): String | ||
</syntaxhighlight> | </syntaxhighlight>'''الإصدار المطلوب''': Kotlin 1.1. | ||
وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]). | |||
== المعاملات == | |||
=== <code>builderAction</code> === | |||
=== <code>capacity</code> === | |||
عددٌ صحيحٌ. إن إن أعطي هذا المعامل <code>capacity</code>، فإنّ الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]] سيأخذ قيمه الابتدائية انطلاقًا من <code>capacity</code>. | |||
==القيم المعادة== | ==القيم المعادة== | ||
[[Kotlin/String|سلسلة نصية]]. | تعاد [[Kotlin/String|سلسلة نصية]]. | ||
==أمثلة== | ==أمثلة== | ||
مثالٌ على استعمال الدالة <code>()buildString</code><nowiki/>:<syntaxhighlight lang="kotlin"> | |||
val x = buildString { | val x = buildString { | ||
append("Lucky numbers: ") | append("Lucky numbers: ") | ||
| سطر 21: | سطر 34: | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
println(x) // Lucky numbers: 12, 60, 56, 27, 30, 50, 26, 72, 70, 27, | println(x) // Lucky numbers: 12, 60, 56, 27, 30, 50, 26, 72, 70, 27, | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | |||
* <code>[[Kotlin/kotlin.text/ | * الدالة <code>[[Kotlin/kotlin.text/StringBuilder/init|StringBuilder()]]</code>: تنشئ كائنًا من النوع <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code>. | ||
==مصادر== | ==مصادر== | ||
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/build-string.html الدالة | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/build-string.html صفحة الدالة buildString() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Text]] | |||
المراجعة الحالية بتاريخ 10:21، 2 سبتمبر 2018
تنشئ الدالة 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)).
المعاملات
builderAction
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.