الفرق بين المراجعتين ل"Kotlin/collections/toCollection"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق.)
سطر 1: سطر 1:
تضيف الدالة<code>toCollection()‎</code> عناصر [[Kotlin/Array|المصفوفة]]  أو  [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها إلى [[Kotlin/MutableCollection|المجموعة المتغيرة]] (<code>MutableCollection</code>) المُمرّرة <code>destination</code>.
+
<noinclude>{{DISPLAYTITLE: الدالة <code>toCollection()‎</code> في Kotlin}}</noinclude>
 +
تضيف الدالة <code>toCollection()‎</code> جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى [[Kotlin/MutableCollection|المجموعة المتغيرة]] (MutableCollection) المُمرّرة إليها.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
سطر 34: سطر 35:
  
 
</syntaxhighlight>
 
</syntaxhighlight>
==القيمة المُعادة==
+
==القيمة المعادة==
[[Kotlin/MutableCollection|المجموعة المتغيرة]] (<code>MutableCollection</code>) المُمرّرة <code>destination</code> بعد إضافة عناصر [[Kotlin/Array|المصفوفة]]  أو  [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها الدالة.
+
تعاد [[Kotlin/MutableCollection|المجموعة المتغيرة]] <code>destination</code> الممررة بعد إضافة جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة إليها.
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة <code>()toCollection</code> مع المصفوفات===
+
<nowiki/><nowiki/>استعمال الدالة <code>()toCollection</code> لإضافة جميع عناصر مصفوفة إلى قائمة متغيرة:<syntaxhighlight lang="kotlin">
تعرّف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>  مكونة من ثلاثة أعداد باستخدام الدالة <code>()arrayOf‎</code>، ثم تعرّف  <nowiki/>[[Kotlin/mutableListOf|لائحة متغيرة]] باسم <code>list</code>  مكونة من ثلاثة أعداد باستخدام الدالة <code>()mutableListOf</code>، ثم تستخدم الدالة <code>()toCollection</code>  على <code>array</code> وتمرر <code>list</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)
var list = mutableListOf(8, 7, 3)
+
    var list = mutableListOf(8, 7, 3)
   
+
 
println(array.toCollection(list)) // [8, 7, 3, 4, 5, 6]
+
    println(array.toCollection(list)) // [8, 7, 3, 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>: تحول [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<out Boolean>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]]  التي استُدعيت معها إلى [[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>‎ : تحوِّل [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Byte>‎</code>) أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى [[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>: تحول [[Kotlin/Array|المصفوفة العامة]] (أي التي من النوع <code>Array<Char>‎</code>) أو [[Kotlin/collections|المجموعة]]  التي استُدعيت معها إلى [[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/CharArray/index|CharArray]]</code>.
 +
*الدالة <code>[[Kotlin/collections/toDoubleArray|toDoubleArray()]]</code>‎ : تحول [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Double>‎</code>) أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى [[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/DoubleArray/index|DoubleArray]]</code>.
 +
*الدالة <code>[[Kotlin/collections/toFloatArray|toFloatArray()‎]]</code>: تحول [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Float>‎</code>) أو [[Kotlin/collections|المجموعة]]  التي استُدعيت معها [[Kotlin/Array|مصفوفة]] من النوع <code>[[Kotlin/FloatArray/index|FloatArray]]</code>.
 
==مصادر==
 
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-collection.html الدالة  toCollection()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-collection.html صفحة الدالة toCollection()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

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

تضيف الدالة toCollection()‎ جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها إلى المجموعة المتغيرة (MutableCollection) المُمرّرة إليها.

البنية العامة

fun <T, C : MutableCollection<in T>> Array<out T>.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Byte>> ByteArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Short>> ShortArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Int>> IntArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Long>> LongArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Float>> FloatArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Double>> DoubleArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Boolean>> BooleanArray.toCollection(
    destination: C
): C 
fun <C : MutableCollection<in Char>> CharArray.toCollection(
    destination: C
): C
fun <T, C : MutableCollection<in T>> Iterable<T>.toCollection(
    destination: C
): C

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

تعاد المجموعة المتغيرة destination الممررة بعد إضافة جميع عناصر المصفوفة أو المجموعة المعطاة إليها.

أمثلة

استعمال الدالة ()toCollection لإضافة جميع عناصر مصفوفة إلى قائمة متغيرة:

fun main(args: Array<String>) {
    val array = arrayOf(4, 5, 6)
    var list = mutableListOf(8, 7, 3)

    println(array.toCollection(list)) // [8, 7, 3, 4, 5, 6]
}

انظر أيضًا

مصادر