الفرق بين المراجعتين ل"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
).