الفرق بين المراجعتين ل"Kotlin/kotlin.text/buildString"

المراجعة الحالية بتاريخ 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.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.buildString()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>buildString()‎</code> في Kotlin}}</noinclude>
-تبني الدالة <code>buildString()‎</code> [[Kotlin/String|سلسلة نصية]] عبر ملأ الكائن من نوع <code>StringBuilder</code>  المُنشأ حديثَا باستخدام  الدالة المُمرّرة <code>builderAction‎</code> ثم تُحولها إلى  [[Kotlin/String|سلسلة نصية]].  في حال تمرير وسيط <code>capacity</code> من نوع <code>Int</code> فإنّ الكائن <code>StringBuilder</code> سيأخذ قيمه الابتدائية انطلاقا من<code>capacity.</code>
+تنشئ الدالة <code>buildString()‎</code> [[Kotlin/String|سلسلة نصية]] جديدة عبر ملئها بالكائن <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code> المُنشأ حديثًا ثم تحويله إلى [[Kotlin/String|سلسلة نصية]].
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
+inline fun buildString(
+    builderAction: StringBuilder.() -> Unit
+): String (source)
+</syntaxhighlight><syntaxhighlight lang="kotlin">
 inline fun buildString(
      capacity: Int,
      builderAction: StringBuilder.() -> Unit
 ): String
-</syntaxhighlight>يلاحظ وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
+</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>===
+مثالٌ على استعمال الدالة <code>()buildString</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>x</code> عبر الدالة <code>()buildString</code>، مع تمرير دالة إليها كوسيط<nowiki/>، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 val x = buildString {
      append("Lucky numbers: ")
@@ سطر 21: / سطر 34: @@
 fun main(args: Array<String>) {
      println(x) // Lucky numbers: 12, 60, 56, 27, 30, 50, 26, 72, 70, 27,
 }
 </syntaxhighlight>
-===انظر أيضًا===
+==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/associateBy|associateBy()]]‎</code>: تعيد قاموسًا (map) يحتوي عناصر سلسلة الحروف التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+* الدالة <code>[[Kotlin/kotlin.text/StringBuilder/init|StringBuilder()]]‎</code>: تنشئ كائنًا من النوع <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code>.
-* <code>[[Kotlin/kotlin.text/associateByTo|associateByTo()]]‎</code>: تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 ==مصادر==
-*[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 صفحة الدالة buildString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]