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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (استبدال النص - '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>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">
 
<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>يلاحظ وجود الكلمة المفتاحية <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 {
 
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 الدالة text.buildString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[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 والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر