الفرق بين المراجعتين لصفحة: «Kotlin/collections/asList»
< Kotlin | collections
لا ملخص تعديل |
مراجعة |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>asList()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>asList()</code> في لغة Kotlin}}</noinclude> | ||
تُعيد الدالة <code>asList()</code> | تُعيد الدالة <code>asList()</code> قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | تختلف بحسب نوع المصفوفة:<syntaxhighlight lang="kotlin"> | ||
fun <T> Array<out T>.asList(): List<T> | fun <T> Array<out T>.asList(): List<T> | ||
fun ByteArray.asList(): List<Byte> | fun ByteArray.asList(): List<Byte> | ||
| سطر 14: | سطر 14: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المعادة== | ==القيم المعادة== | ||
قائمة (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها. | |||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>() | ===استخدام الدالة <code>()asList</code> مع المصفوفات=== | ||
تعرِّف الشيفرة الآتية مصفوفةً باسم <code>array</code> مكوَّنة من حرفين باستخدام الدالة <code>()arrayOf</code>، ثم تنشئ قائمةً باسم <code>list</code> من المصفوفة <code>array</code> وذلك باستخدام الدالة <code>()asList</code> ثم تطبع تلك القائمة:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val array = arrayOf("a", "b") | val array = arrayOf("a", "b") | ||
| سطر 26: | سطر 26: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
*<code>[[Kotlin/collections/asIterable|asIterable()]]</code>: | *<code>[[Kotlin/collections/asIterable|asIterable()]]</code>: تُعيد نسخةً تكراريّةً (iterable instance) تُغلّف (wrap) المصفوفة الأصلية وتعيد عناصرَها عندما تُستخدَم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>). | ||
*<code>[[Kotlin/collections/asSequence|asSequence()]]</code>: تعيد | *<code>[[Kotlin/collections/asSequence|asSequence()]]</code>: تعيد نسخةً من النوع sequence والتي تُغلّف المصفوفة الأصليّة وتعيد عناصرها عندما تُستخدَم في حلقات التكرار (مثل حلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>). | ||
==مصادر | ==مصادر<span> </span>== | ||
<span> </span> | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/as-list.html صفحة الدالة ()asList في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/as-list.html | |||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
مراجعة 05:12، 2 يوليو 2018
تُعيد الدالة asList() قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها.
البنية العامة
تختلف بحسب نوع المصفوفة:
fun <T> Array<out T>.asList(): List<T>
fun ByteArray.asList(): List<Byte>
fun ShortArray.asList(): List<Short>
fun IntArray.asList(): List<Int>
fun LongArray.asList(): List<Long>
fun FloatArray.asList(): List<Float>
fun DoubleArray.asList(): List<Double>
fun BooleanArray.asList(): List<Boolean>
fun CharArray.asList(): List<Char>
القيم المعادة
قائمة (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها.
أمثلة
استخدام الدالة ()asList مع المصفوفات
تعرِّف الشيفرة الآتية مصفوفةً باسم array مكوَّنة من حرفين باستخدام الدالة ()arrayOf، ثم تنشئ قائمةً باسم list من المصفوفة array وذلك باستخدام الدالة ()asList ثم تطبع تلك القائمة:
fun main(args: Array<String>) {
val array = arrayOf("a", "b")
val list = array.asList()
println(list) // [a, b]
}
انظر أيضًا
asIterable(): تُعيد نسخةً تكراريّةً (iterable instance) تُغلّف (wrap) المصفوفة الأصلية وتعيد عناصرَها عندما تُستخدَم في حلقات التكرار (مثلfor).asSequence(): تعيد نسخةً من النوع sequence والتي تُغلّف المصفوفة الأصليّة وتعيد عناصرها عندما تُستخدَم في حلقات التكرار (مثل حلقةfor).