Kotlin/collections/toList

تعيد الدالةtoList()‎ لائحة تضم جميع عناصر المصفوفة  أو المجموعة التكرارية  التي استُدعيت عبرها. وفي حال استدعاء الدالةtoList()‎ عبر قاموس فستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.

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

يمكن استدعاء الدالةtoList()‎ عبر المصفوفات  أو المجموعات التكرارية:

fun <T> Array<out T>.toList(): List<T> 
fun ByteArray.toList(): List<Byte> 
fun ShortArray.toList(): List<Short> 
fun IntArray.toList(): List<Int> 
fun LongArray.toList(): List<Long>
fun FloatArray.toList(): List<Float> 
fun DoubleArray.toList(): List<Double> 
fun BooleanArray.toList(): List<Boolean> 
fun CharArray.toList(): List<Char>
fun <T> Iterable<T>.toList(): List<T>

يمكن استدعاء الدالةtoList()‎ عبر القواميس:

fun <K, V> Map<out K, V>.toList(): List<Pair<K, V>>

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

لائحة تضم جميع عناصر المصفوفة  أو المجموعة التكرارية  التي استُدعيت عبرها. وفي حال استدعاء الدالةtoList()‎ عبر قاموس فستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.

أمثلة

استخدام الدالة ()toList مع المصفوفات

تعرّف الشيفرة الآتية  مصفوفة باسم array  مكونة من ثلاثة أعداد باستخدام الدالة ()arrayOf‎، ثم تستخدم الدالة()toList على array، ثم تطبع الناتج:

fun main(args: Array<String>) {
val array = arrayOf(4, 5, 6)

println(array.toList()) // [4, 5, 6]
}

أنظر أيضًا

• toBooleanArray()‎ : تعيد مصفوفة من القيم المنطقية (من النوع BooleanArray) تضم جميع عناصر المصفوفة العامة (أي من النوعArray<out Boolean>‎) أو المجموعة  التي استُدعيت عبرها.
• toByteArray()‎ : تعيد مصفوفة من النوع ByteArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Byte>‎) أو المجموعة  التي استُدعيت عبرها.
• toDoubleArray()‎ : تعيد مصفوفة من النوع DoubleArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Double>‎) أو المجموعة  التي استُدعيت عبرها.

مصادر

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