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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث

تضيف الدالة toCollection()‎ جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها.

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

fun <T, C : MutableCollection<in T>> Array<out T>.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Byte>> ByteArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Short>> ShortArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Int>> IntArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Long>> LongArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Float>> FloatArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Double>> DoubleArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Boolean>> BooleanArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Char>> CharArray.toCollection(
    destination: C
): C
fun <T, C : MutableCollection<in T>> Iterable<T>.toCollection(
    destination: C
): C

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

تعاد المجموعة المتغيرة destination الممررة بعد إضافة جميع عناصر المصفوفة أو المجموعة المعطاة إليها.

أمثلة

استعمال الدالة ()toCollection لإضافة جميع عناصر مصفوفة إلى قائمة متغيرة:

fun main(args: Array<String>) {
    val array = arrayOf(4, 5, 6)
    var list = mutableListOf(8, 7, 3)

    println(array.toCollection(list)) // [8, 7, 3, 4, 5, 6]
}

انظر أيضًا

  • الدالة toMap()‎: تحول الكائن المستدعى معها إلى خريطة أو تضيف محتوى ذلك الكائن إلى خريطة موجودة مسبقًا.
  • الدالة toMutableList()‎: تحول المصفوف أو المجموعة التي استُدعيت معها إلى قائمة متغيرة. 
  • الدالة toMutableSet()‎: تحول المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع MutableSet.
  • الدالة toShortArray()‎: تحول المصفوفة العامة (أي من النوع Array<Short>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع ShortArray.
  • الدالة toSortedSet()‎: تحول المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع SortedSet ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة.

مصادر