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

من موسوعة حسوب
→ التعديل السابقالتعديل اللاحق ←
مرئينص الويكي
لا ملخص تعديل
ط مراجعة وتدقيق.
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>toList()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>toList()‎</code> في Kotlin}}</noinclude>
تعيد الدالة<code>toList()‎</code> [[Kotlin/List|لائحة]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]  أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد [[Kotlin/List|لائحة]] تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
تحول الدالة <code>toList()‎</code> [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] أو [[Kotlin/Map|الخريطة]] التي استُدعيت معها إلى قائمة.
==البنية العامة==
==البنية العامة==
يمكن استدعاء الدالة<code>toList()‎</code> عبر [[Kotlin/Array|المصفوفات]]  أو  [[Kotlin/Iterable|المجموعات التكرارية]]:<syntaxhighlight lang="kotlin">
يمكن استدعاء الدالة <code>toList()‎</code> مع [[Kotlin/Array|المصفوفات]] أو [[Kotlin/Iterable|المجموعات التكرارية]] أو [[Kotlin/Map|الخرائط]]:<syntaxhighlight lang="kotlin">
fun <T> Array<out T>.toList(): List<T>  
fun <T> Array<out T>.toList(): List<T>  
fun ByteArray.toList(): List<Byte>  
fun ByteArray.toList(): List<Byte>  
سطر 12: سطر 12:
fun BooleanArray.toList(): List<Boolean>  
fun BooleanArray.toList(): List<Boolean>  
fun CharArray.toList(): List<Char>
fun CharArray.toList(): List<Char>
fun <T> Iterable<T>.toList(): List<T>  
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>>
fun <K, V> Map<out K, V>.toList(): List<Pair<K, V>>


</syntaxhighlight>
</syntaxhighlight>
==القيمة المُعادة==
==القيمة المعادة==
[[Kotlin/List|لائحة]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]  أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد [[Kotlin/List|لائحة]] تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
تعاد [[Kotlin/List|قائمة]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] أو جميع أزواج الخريطة المعطاة.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()toList</code> مع المصفوفات===
<nowiki/>استعمال الدالة <code>()toList</code> لتحويل مصفوفة إلى قائمة:<syntaxhighlight lang="kotlin">
تعرّف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>  مكونة من ثلاثة أعداد باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()toList</code> على <code>array</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val array = arrayOf(4, 5, 6)
    val array = arrayOf(4, 5, 6)


println(array.toList()) // [4, 5, 6]
    println(array.toList()) // [4, 5, 6]
}
}
</syntaxhighlight>
</syntaxhighlight>
==أنظر أيضًا==
==انظر أيضًا==
*<code>[[Kotlin/collections/toBooleanArray|toBooleanArray()]]</code>‎ : تعيد [[Kotlin/Array|مصفوفة]] من القيم المنطقية (من النوع <code>BooleanArray</code>) تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع<code>Array<out Boolean>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
* الدالة <code>[[Kotlin/collections/toBooleanArray|toBooleanArray()]]</code>‎: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<out Boolean>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من القيم المنطقية (من النوع <code>[[Kotlin/BooleanArray/index|BooleanArray]]</code>).
*<code>[[Kotlin/collections/toByteArray|toByteArray()]]</code>‎ : تعيد <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>ByteArray</code>تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Byte>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
* الدالة <code>[[Kotlin/collections/toByteArray|toByteArray()]]</code>‎ : تحوِّل <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Byte>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>ByteArray</code>.
*<code>[[Kotlin/collections/toDoubleArray|toDoubleArray()]]</code>‎ : تعيد [[Kotlin/Array|مصفوفة]] من النوع <code>DoubleArray</code>تضم جميع عناصر [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Double>‎</code>) أو [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
* الدالة <code>[[Kotlin/collections/toCharArray|toCharArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي التي من النوع <code>Array<Char>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/CharArray/index|CharArray]]</code>.
* الدالة <code>[[Kotlin/collections/toCollection|toCollection()‎]]</code>: تضيف جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها.
* الدالة <code>[[Kotlin/collections/toDoubleArray|toDoubleArray()]]</code>‎ : تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Double>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/DoubleArray/index|DoubleArray]]</code>.
* الدالة <code>[[Kotlin/collections/toFloatArray|toFloatArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Float>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت معها <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/FloatArray/index|FloatArray]]</code>.
*الدالة <code>[[Kotlin/collections/toHashSet|toHashSet()]]‎</code>: تعيد كائنًا من النوع <code>HashSet</code> لجميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
*الدالة <code>[[Kotlin/collections/toIntArray|toIntArray()‎]]</code>: تحول [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Int>‎</code>) أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى [[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/IntArray/index|IntArray]]</code>.
*الدالة <code>[[Kotlin/collections/toLongArray|toLongArray()‎]]</code>: تحول [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Long>‎</code>) أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى [[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/LongArray/index|LongArray]]</code>.
==مصادر==
==مصادر==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-list.html الدالة  toList()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-list.html صفحة الدالة toList()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Functions]]

مراجعة 18:24، 8 أغسطس 2018

تحول الدالة 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> 

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

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

تعاد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التكرارية أو جميع أزواج الخريطة المعطاة.

أمثلة

استعمال الدالة ()toList لتحويل مصفوفة إلى قائمة:

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

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

انظر أيضًا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/collections/toList&oldid=14667»