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

من موسوعة حسوب
لا ملخص تعديل
مراجعة
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>asList()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>asList()‎</code> في لغة Kotlin}}</noinclude>
تُعيد الدالة <code>asList()‎</code> لائحة (list) والتي تُغلّف المصفوفة الاصلية التي استُدعيت عبرها.
تُعيد الدالة <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) تُغلّف المصفوفة الاصلية التي استُدعيت عبرها.
قائمة (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()</code><code>asList</code>مع المصفوفات===
===استخدام الدالة <code>()asList</code> مع المصفوفات===
تعرف الشيفرة الآتية مصفوفة باسم <code>array</code> مكونة من حرفين باستخدام الدالة <code>()arrayOf</code>، ثم تنشئ لائحة من المصفوفة <code>array</code> باسم  <code>list</code> باستخدام <code>()</code><code>asList</code> ثم تطبع تلك اللائحة:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية مصفوفةً باسم <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>‎: تُنشئ نسخة تكرارية (Iterable instance) والتي تُغلّف المصفوفة الاصلية وتعيد عناصرها عندما تُستخدم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</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>‎: تعيد نسخة من النوع Sequence  والتي تُغلّف المصفوفة الاصلية وتعيد عناصرها عندما تطبق تستخدم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</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 الدالة  ()asList‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف: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).

مصادر