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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.buildString()‎</code> في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>buildString()‎</code> في Kotlin}}</noinclude>
 
تنشئ الدالة <code>buildString()‎</code> [[Kotlin/String|سلسلة نصية]] جديدة عبر ملئها بالكائن <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code> المُنشأ حديثًا ثم تحويله إلى [[Kotlin/String|سلسلة نصية]].  
 
تنشئ الدالة <code>buildString()‎</code> [[Kotlin/String|سلسلة نصية]] جديدة عبر ملئها بالكائن <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code> المُنشأ حديثًا ثم تحويله إلى [[Kotlin/String|سلسلة نصية]].  
 
==البنية العامة==
 
==البنية العامة==
سطر 38: سطر 38:
 
</syntaxhighlight>
 
</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> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 
  
 
==مصادر==
 
==مصادر==
سطر 47: سطر 44:
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Function]]
 
[[تصنيف: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,
}

انظر أيضًا

مصادر