الفرق بين المراجعتين لصفحة: «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/MutableMap|القاموس المتغير]] <code>destination</code>  بأزواج من "مفتاح/قيمة"،  حيث القيمة هي عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها،  والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>transform</code>.
+تنشئ الدالة <code>buildString()‎</code> [[Kotlin/String|سلسلة نصية]] جديدة عبر ملئها بالكائن <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code> المُنشأ حديثًا ثم تحويله إلى [[Kotlin/String|سلسلة نصية]].
-إن كان لعنصرين نفس المفتاح (key) بعد تطبيق الدالة <code>keySelector</code>، فإنَّ الأخير هو الذي سيُضاف إلى القاموس.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateTo(
+inline fun buildString(
-     destination: M,
+    builderAction: StringBuilder.() -> Unit
-     transform: (Char) -> Pair<K, V>
+): String (source)
-): M
+</syntaxhighlight><syntaxhighlight lang="kotlin">
-</syntaxhighlight>يلاحظ وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]).
+inline fun buildString(
+     capacity: Int,
+     builderAction: StringBuilder.() -> Unit
+): String
+</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/MutableMap|قاموس متغير]].
+تعاد [[Kotlin/String|سلسلة نصية]].
 ==أمثلة==
-===استخدام الدالة <code>()buildString</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()buildString</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تنشئ  [[Kotlin/MutableMap|قاموسا متغيرا]]  باسم <code>map،</code> ثم تمرّر الدالة <code>()func</code> (التي تحول الحرف إلى زوج مكون من الحرف في الحالة الكبيرة UpperCase والحالة الصغيرة LowerCase) و<nowiki/>[[Kotlin/MutableMap|القاموس المتغير]] <code>map</code> إلى <code>()buildString</code>، ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+val x = buildString {
+    append("Lucky numbers: ")
+    for (i in 1..10) {
+        append("${(Math.random() * 100).toInt()}, ")
+    }
+}
 fun main(args: Array<String>) {
-val str = "hsoub"
+    println(x) // Lucky numbers: 12, 60, 56, 27, 30, 50, 26, 72, 70, 27,
-val map = mutableMapOf<Char, Char>()
-val func: (Char) -> Pair<Char, Char> = {
-    Pair(it.toUpperCase(), it.toLowerCase())
-}
-str.associateTo(map,func)
-println(map) // {H=h, S=s, O=o, U=u, B=b}
 }
 </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/associate-to.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]]