الفرق بين المراجعتين لصفحة: «Kotlin/collections/toList»

مراجعة 09:02، 24 يونيو 2018

تعيد الدالة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.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>toList()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة<code>toList()‎</code> [[Kotlin/Array|مصفوفة]] من  النوع <code>IntArray</code>تضم جميع عناصر [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Int>‎</code>) أو  [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
+تعيد الدالة<code>toList()‎</code> [[Kotlin/List|لائحة]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]   أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد [[Kotlin/List|لائحة]] تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
 ==البنية العامة==
-<syntaxhighlight lang="kotlin">
+يمكن استدعاء الدالة<code>toList()‎</code>  عبر [[Kotlin/Array|المصفوفات]]   أو  [[Kotlin/Iterable|المجموعات التكرارية]]:<syntaxhighlight lang="kotlin">
-fun Array<out Int>.toIntArray(): IntArray
+fun <T> Array<out T>.toList(): List<T>
-fun Collection<Int>.toIntArray(): IntArray
+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>
+</syntaxhighlight>يمكن استدعاء الدالة<code>toList()‎</code>  عبر [[Kotlin/Map|القواميس]]:<syntaxhighlight lang="kotlin">
+fun <K, V> Map<out K, V>.toList(): List<Pair<K, V>>
 </syntaxhighlight>
 ==القيمة المُعادة==
-[[Kotlin/Array|مصفوفة]] من  النوع <code>IntArray</code>تضم جميع عناصر [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Int>‎</code>) أو  [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
+[[Kotlin/List|لائحة]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]   أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد [[Kotlin/List|لائحة]] تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
 ==أمثلة==
 ===استخدام الدالة <code>()toList</code> مع المصفوفات===
-تعرّف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> من النوع <code>Array<Int>‎</code> مكونة من ثلاثة أعداد باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()toList</code> على <code>array</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرّف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>  مكونة من ثلاثة أعداد باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()toList</code> على <code>array</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
-import java.util.Arrays
 fun main(args: Array<String>) {
-val array : Array <Int> = arrayOf(4, 5, 6)
+val array = arrayOf(4, 5, 6)
-println(Arrays.toString (array.toIntArray()) ) // [4, 5, 6]
+println(array.toList()) // [4, 5, 6]
 }
 </syntaxhighlight>