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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>toSortedSet()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>toSortedSet()‎</code> Kotlin/List|...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>toSortedSet()‎</code> في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>toSortedSet()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة<code>toSortedSet()‎</code> [[Kotlin/List|لائحة]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]   أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد [[Kotlin/List|لائحة]] تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
+
تعيد الدالة<code>toSortedSet()‎</code> [[Kotlin/SortedSet|مجموعة من النوع <code>SortedSet</code>]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]   أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها. وفي حال تمرير دالة مقارنة <code>comparator</code> إلى الدالة<code>toSortedSet()‎</code> فسترتب المجموعة المعادة حسب ذلك المقارِن.
 
==البنية العامة==
 
==البنية العامة==
 
يمكن استدعاء الدالة<code>toSortedSet()‎</code>  عبر [[Kotlin/Array|المصفوفات]]   أو  [[Kotlin/Iterable|المجموعات التكرارية]]:<syntaxhighlight lang="kotlin">
 
يمكن استدعاء الدالة<code>toSortedSet()‎</code>  عبر [[Kotlin/Array|المصفوفات]]   أو  [[Kotlin/Iterable|المجموعات التكرارية]]:<syntaxhighlight lang="kotlin">
fun <T> Array<out T>.toList(): List<T>  
+
fun <T : Comparable<T>> Array<out T>.toSortedSet(): SortedSet<T>
fun ByteArray.toList(): List<Byte>  
+
fun ByteArray.toSortedSet(): SortedSet<Byte>
fun ShortArray.toList(): List<Short>  
+
fun ShortArray.toSortedSet(): SortedSet<Short>  
fun IntArray.toList(): List<Int>  
+
fun IntArray.toSortedSet(): SortedSet<Int>  
fun LongArray.toList(): List<Long>
+
fun LongArray.toSortedSet(): SortedSet<Long>  
fun FloatArray.toList(): List<Float>  
+
fun FloatArray.toSortedSet(): SortedSet<Float>  
fun DoubleArray.toList(): List<Double>  
+
fun DoubleArray.toSortedSet(): SortedSet<Double>  
fun BooleanArray.toList(): List<Boolean>  
+
fun BooleanArray.toSortedSet(): SortedSet<Boolean>  
fun CharArray.toList(): List<Char>
+
fun CharArray.toSortedSet(): SortedSet<Char>  
fun <T> Iterable<T>.toList(): List<T>  
+
fun <T : Comparable<T>> Iterable<T>.toSortedSet(): SortedSet<T>  
</syntaxhighlight>يمكن استدعاء الدالة<code>toSortedSet()‎</code>  عبر [[Kotlin/Map|القواميس]]:<syntaxhighlight lang="kotlin">
 
fun <K, V> Map<out K, V>.toList(): List<Pair<K, V>>
 
  
 +
</syntaxhighlight>يمكن استدعاء الدالة<code>toSortedSet()‎</code>  عبر [[Kotlin/Array|المصفوفات]]   أو  [[Kotlin/Iterable|المجموعات التكرارية]] مع تمرير دالة مقارنة <code>comparator</code>:<syntaxhighlight lang="kotlin">
 +
fun <T> Array<out T>.toSortedSet(
 +
    comparator: Comparator<in T>
 +
): SortedSet<T>
 +
fun <T> Iterable<T>.toSortedSet(
 +
    comparator: Comparator<in T>
 +
): SortedSet<T>
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==القيمة المُعادة==
 
==القيمة المُعادة==
[[Kotlin/List|لائحة]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]   أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر [[Kotlin/Map|قاموس]] فستعيد [[Kotlin/List|لائحة]] تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
+
[[Kotlin/SortedSet|مجموعة من النوع <code>SortedSet</code>]] تضم جميع عناصر [[Kotlin/Array|المصفوفة]]   أو  [[Kotlin/Iterable|المجموعة التكرارية]]  التي استُدعيت عبرها. وفي حال تمرير دالة مقارنة <code>comparator</code> إلى الدالة<code>toSortedSet()‎</code> فسترتب المجموعة المعادة حسب ذلك المقارِن.
 
==أمثلة==
 
==أمثلة==
 
===استخدام الدالة <code>()toSortedSet</code> مع المصفوفات===
 
===استخدام الدالة <code>()toSortedSet</code> مع المصفوفات===
 
تعرّف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>  مكونة من ثلاثة أعداد باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()toSortedSet</code> على <code>array</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
تعرّف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>  مكونة من ثلاثة أعداد باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()toSortedSet</code> على <code>array</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, 4, 1, 6)
  
println(array.toList()) // [4, 5, 6]
+
println(array.toSortedSet()) // [1, 4, 5, 6]
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
سطر 33: سطر 38:
 
*<code>[[Kotlin/collections/toDoubleArray|toDoubleArray()]]</code>‎ : تعيد [[Kotlin/Array|مصفوفة]] من  النوع <code>DoubleArray</code>تضم جميع عناصر [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Double>‎</code>) أو  [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
 
*<code>[[Kotlin/collections/toDoubleArray|toDoubleArray()]]</code>‎ : تعيد [[Kotlin/Array|مصفوفة]] من  النوع <code>DoubleArray</code>تضم جميع عناصر [[Kotlin/Array|المصفوفة العامة]] (أي من النوع <code>Array<Double>‎</code>) أو  [[Kotlin/collections|المجموعة]]  التي استُدعيت عبرها.
 
==مصادر==
 
==مصادر==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-list.html الدالة  toSortedSet()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/to-sorted-set.html الدالة  toSortedSet()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

مراجعة 11:32، 24 يونيو 2018

تعيد الدالةtoSortedSet()‎ مجموعة من النوع SortedSet تضم جميع عناصر المصفوفة  أو المجموعة التكرارية  التي استُدعيت عبرها. وفي حال تمرير دالة مقارنة comparator إلى الدالةtoSortedSet()‎ فسترتب المجموعة المعادة حسب ذلك المقارِن.

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

يمكن استدعاء الدالةtoSortedSet()‎ عبر المصفوفات  أو المجموعات التكرارية:

fun <T : Comparable<T>> Array<out T>.toSortedSet(): SortedSet<T>
fun ByteArray.toSortedSet(): SortedSet<Byte>
fun ShortArray.toSortedSet(): SortedSet<Short> 
fun IntArray.toSortedSet(): SortedSet<Int> 
fun LongArray.toSortedSet(): SortedSet<Long> 
fun FloatArray.toSortedSet(): SortedSet<Float> 
fun DoubleArray.toSortedSet(): SortedSet<Double> 
fun BooleanArray.toSortedSet(): SortedSet<Boolean> 
fun CharArray.toSortedSet(): SortedSet<Char> 
fun <T : Comparable<T>> Iterable<T>.toSortedSet(): SortedSet<T>

يمكن استدعاء الدالةtoSortedSet()‎ عبر المصفوفات  أو المجموعات التكرارية مع تمرير دالة مقارنة comparator:

fun <T> Array<out T>.toSortedSet(
    comparator: Comparator<in T>
): SortedSet<T>
fun <T> Iterable<T>.toSortedSet(
    comparator: Comparator<in T>
): SortedSet<T>

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

مجموعة من النوع SortedSet تضم جميع عناصر المصفوفة  أو المجموعة التكرارية  التي استُدعيت عبرها. وفي حال تمرير دالة مقارنة comparator إلى الدالةtoSortedSet()‎ فسترتب المجموعة المعادة حسب ذلك المقارِن.

أمثلة

استخدام الدالة ()toSortedSet مع المصفوفات

تعرّف الشيفرة الآتية  مصفوفة باسم array  مكونة من ثلاثة أعداد باستخدام الدالة ()arrayOf‎، ثم تستخدم الدالة()toSortedSet على array، ثم تطبع الناتج:

fun main(args: Array<String>) {
val array = arrayOf(4, 5, 6, 4, 1, 6)

println(array.toSortedSet()) // [1, 4, 5, 6]
}

أنظر أيضًا

مصادر