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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>toCollection()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>toCollection()‎</code> Kotlin/Arra...'
 
طلا ملخص تعديل
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>toCollection()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>toCollection()‎</code> في Kotlin}}</noinclude>
تعيد الدالة<code>toCollection()‎</code> [[Kotlin/Array|مصفوفة]] من  النوع <code>FloatArray</code>تضم جميع عناصر [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Float>‎</code>) أو  [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
تضيف الدالة <code>toCollection()‎</code> جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى [[Kotlin/MutableCollection|المجموعة المتغيرة]] (MutableCollection) المُمرّرة إليها.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
fun Array<out Float>.toFloatArray(): FloatArray
fun <T, C : MutableCollection<in T>> Array<out T>.toCollection(
fun Collection<Float>.toFloatArray(): FloatArray
    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


</syntaxhighlight>
</syntaxhighlight>
==القيمة المُعادة==
==القيمة المعادة==
[[Kotlin/Array|مصفوفة]] من  النوع <code>FloatArray</code>تضم جميع عناصر [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Float>‎</code>) أو  [[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>Array<Float>‎</code> مكونة من ثلاثة أعداد باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()toCollection</code> على <code>array</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
import java.util.Arrays
    val array = arrayOf(4, 5, 6)
    var list = mutableListOf(8, 7, 3)


fun main(args: Array<String>) {
    println(array.toCollection(list)) // [8, 7, 3, 4, 5, 6]
val array : Array <Float> = arrayOf(4.5f, 5.4f, 6.0f)
println(Arrays.toString (array.toFloatArray()) ) // [4.5, 5.4, 6.0]
}
}
</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/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> لجميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها.
* الدالة <code>[[Kotlin/collections/toIntArray|toIntArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Int>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>IntArray</code>.
* الدالة <code>[[Kotlin/collections/toList|toList()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية أو الخريطة التي استُدعيت معها إلى قائمة.
* الدالة <code>[[Kotlin/collections/toLongArray|toLongArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Long>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>LongArray</code>.
 
* الدالة <code>[[Kotlin/collections/toMap|toMap()‎]]</code>: تحول الكائن المستدعى معها إلى خريطة أو تضيف محتوى ذلك الكائن إلى خريطة موجودة مسبقًا.
* الدالة <code>[[Kotlin/collections/toMutableList|toMutableList()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوف]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى قائمة متغيرة. 
* الدالة <code>[[Kotlin/collections/toMutableSet|toMutableSet()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع <code>MutableSet</code>.
* الدالة <code>[[Kotlin/collections/toShortArray|toShortArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Short>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>ShortArray</code>.
* الدالة <code>[[Kotlin/collections/toSortedSet|toSortedSet()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع <code>SortedSet</code> ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة.
 
*الدالة <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>‎ : تحوِّل [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Byte>‎</code>) أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى [[Kotlin/Array|مصفوفة]] من  النوع <code>ByteArray</code>.
*الدالة <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>.
* الدالة <code>[[Kotlin/collections/toMap|toMap()‎]]</code>: تحول الكائن المستدعى معها إلى خريطة أو تضيف محتوى ذلك الكائن إلى خريطة موجودة مسبقًا.
* الدالة <code>[[Kotlin/collections/toMutableList|toMutableList()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوف]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى قائمة متغيرة. 
* الدالة <code>[[Kotlin/collections/toMutableSet|toMutableSet()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع <code>MutableSet</code>.
* الدالة <code>[[Kotlin/collections/toSet|toSet()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع <code>Set</code>.
* الدالة <code>[[Kotlin/collections/toShortArray|toShortArray()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Short>‎</code>) أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إلى <nowiki/>[[Kotlin/Array|مصفوفة]] من النوع <code>ShortArray</code>.
* الدالة <code>[[Kotlin/collections/toSortedSet|toSortedSet()‎]]</code>: تحول <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع <code>SortedSet</code> ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة.
==مصادر==
==مصادر==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-float-array.html الدالة  toCollection()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-collection.html صفحة الدالة toCollection()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 11:39، 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]
}

انظر أيضًا

  • الدالة toMap()‎: تحول الكائن المستدعى معها إلى خريطة أو تضيف محتوى ذلك الكائن إلى خريطة موجودة مسبقًا.
  • الدالة toMutableList()‎: تحول المصفوف أو المجموعة التي استُدعيت معها إلى قائمة متغيرة. 
  • الدالة toMutableSet()‎: تحول المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع MutableSet.
  • الدالة toShortArray()‎: تحول المصفوفة العامة (أي من النوع Array<Short>‎) أو المجموعة التي استُدعيت معها إلى مصفوفة من النوع ShortArray.
  • الدالة toSortedSet()‎: تحول المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع SortedSet ثمَّ تعيدها فقط إن لم يمرَّر إليها أي شيء، أو ترتِّبها وفقًا لترتيب معيَّن ثمَّ تعيدها إن مرِّرت إليها دالة مقارنة.

مصادر

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