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

مراجعة 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]
}

أنظر أيضًا

toBooleanArray()‎ : تعيد مصفوفة من القيم المنطقية (من النوع BooleanArray) تضم جميع عناصر المصفوفة العامة (أي من النوعArray<out Boolean>‎) أو المجموعة التي استُدعيت عبرها.
toByteArray()‎ : تعيد مصفوفة من النوع ByteArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Byte>‎) أو المجموعة التي استُدعيت عبرها.
toDoubleArray()‎ : تعيد مصفوفة من النوع DoubleArrayتضم جميع عناصر المصفوفة العامة (أي من النوع Array<Double>‎) أو المجموعة التي استُدعيت عبرها.

مصادر

الدالة toSortedSet()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <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">
-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>
 ==القيمة المُعادة==
-[[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> مع المصفوفات===
 تعرّف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code>  مكونة من ثلاثة أعداد باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()toSortedSet</code> على <code>array</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 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>
@@ سطر 33: / سطر 38: @@
 *<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 Functions]]