الدالة toCollection()‎ في Kotlin

تضيف الدالة toCollection()‎ كل محارف السلسلة التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.

البنية العامة

fun <C : MutableCollection<in Char>> CharSequence.toCollection(
    destination: C
): C

المعاملات

مجموعة متغيرة يراد أن يضاف فيها محتوى سلسلة المحارف المعطاة.

القيم المعادة

يعاد المعامل destination بعد إضافة محتوى سلسلة المحارف المعطاة إليه.

أمثلة

مثالٌ على استعمال الدالة toCollection()‎:

fun main(args: Array<String>) {
    val list: MutableList<Char> = mutableListOf()
    val str = "wikiHsoub"

    str.toCollection(list)
    println(list) // [w, i, k, i, H, s, o, u, b]
}

انظر أيضًا

• الدالة toByteArray()‎: ترمز جميع محارف السلسلة النصية التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع ByteArray.
• الدالة toCharArray()‎: تضع جميع محارف السلسلة النصية التي استٌدعيت معها في مصفوفة من النوع CharArray، إذ يوضع كل محرف في عنصر.

• الدالة toFloat()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري.
• الدالة toHashSet()‎: تحلّل كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها.
• الدالة toLowerCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase).
• الدالة toMutableList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة متغيرة، إذ يوضع كل محرف في عنصر.
• الدالة toPattern()‎: تحول السلسلة النصية التي استٌدعيت معها إلى نمط.
• الدالة toRegex()‎: تحول السلسلة النصية التي استٌدعيت معها إلى تعبير نمطي (regular expression). 
• الدالة toSet()‎: تضيف كل محارف سلسلة الحروف  التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر.
• الدالة toSortedSet()‎: تضيف كل محارف السلسلة  التي استٌدعيت معها إلى مجموعة من النوع SortedSet، إذ يوضع كل محرف في عنصر.
• الدالة toString()‎ : تحول العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية.
• الدالة toUpperCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).

مصادر

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