الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/buildString»
< Kotlin | kotlin.text
ط استبدال النص - 'Kotlin Functions' ب'Kotlin Function' |
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>text.buildString()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>text.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/associateBy|associateBy()]]</code>: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>. | * <code>[[Kotlin/kotlin.text/associateBy|associateBy()]]</code>: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>. | ||
| سطر 31: | سطر 44: | ||
==مصادر== | ==مصادر== | ||
*[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 Function]] | [[تصنيف:Kotlin Function]] | ||
مراجعة 09:16، 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,
}
انظر أيضًا
associateBy(): تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالةkeySelector.
associateByTo(): تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالةkeySelector.asSequence(): تنشئ كائنًا من الصنفSequenceوالذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.