الفرق بين المراجعتين ل"Kotlin/kotlin.text/buildString"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.buildString()</code> في لغة Kotlin}}</noinclude> تملأ الدالة <code>buildString()</code> Kotlin/...') |
|||
| سطر 15: | سطر 15: | ||
===استخدام الدالة <code>()buildString</code> مع سلسلة نصية=== | ===استخدام الدالة <code>()buildString</code> مع سلسلة نصية=== | ||
تعرِّف الشيفرة الآتية سلسلة نصية باسم <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"> | تعرِّف الشيفرة الآتية سلسلة نصية باسم <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>) { | fun main(args: Array<String>) { | ||
| − | + | println(x) // Lucky numbers: 12, 60, 56, 27, 30, 50, 26, 72, 70, 27, | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
مراجعة 18:59، 7 يوليو 2018
تملأ الدالة buildString() القاموس المتغير destination بأزواج من "مفتاح/قيمة"، حيث القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة transform.
إن كان لعنصرين نفس المفتاح (key) بعد تطبيق الدالة keySelector، فإنَّ الأخير هو الذي سيُضاف إلى القاموس.
البنية العامة
inline fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateTo(
destination: M,
transform: (Char) -> Pair<K, V>
): M
يلاحظ وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions)).
القيم المعادة
أمثلة
استخدام الدالة ()buildString مع سلسلة نصية
تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تنشئ قاموسا متغيرا باسم map، ثم تمرّر الدالة ()func (التي تحول الحرف إلى زوج مكون من الحرف في الحالة الكبيرة UpperCase والحالة الصغيرة LowerCase) والقاموس المتغير map إلى ()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والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.