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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>sortedArray()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>sortedArray()‎</code> Kotlin/List|...'
 
طلا ملخص تعديل
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>sortedArray()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>sortedArray()‎</code> في Kotlin}}</noinclude>
تعيد الدالة<code>sortedArray()‎</code> [[Kotlin/List|لائحة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.  
ترتِّب الدالة <code>sortedArray()‎</code> جميع عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في [[Kotlin/List|مصفوفة]] جديدة. 


==البنية العامة==
==البنية العامة==
<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
fun <T : Comparable<T>> Array<out T>.sorted(): List<T>  
fun <T : Comparable<T>> Array<T>.sortedArray(): Array<T>  
fun ByteArray.sorted(): List<Byte>
fun ByteArray.sortedArray(): ByteArray
fun ShortArray.sorted(): List<Short>
fun ShortArray.sortedArray(): ShortArray
fun IntArray.sorted(): List<Int>
fun IntArray.sortedArray(): IntArray
fun LongArray.sorted(): List<Long>
fun LongArray.sortedArray(): LongArray
fun FloatArray.sorted(): List<Float>
fun FloatArray.sortedArray(): FloatArray
fun DoubleArray.sorted(): List<Double>
fun DoubleArray.sortedArray(): DoubleArray
fun CharArray.sorted(): List<Char>
fun CharArray.sortedArray(): CharArray
fun <T : Comparable<T>> Iterable<T>.sorted(): List<T>
</syntaxhighlight>
</syntaxhighlight>


== القيمة المُعادة ==
== القيمة المعادة ==
[[Kotlin/List|لائحة]] تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.
تعاد [[Kotlin/Array|مصفوفة]] جديدة تضم عناصر [[Kotlin/Array|المصفوفة]] المعطاة بعد ترتيبها تصاعديًّا.


==أمثلة==
==أمثلة==
===استخدام الدالة <code>()sortedArray</code> مع المصفوفات===
<nowiki/><nowiki/>استعمال الدالة <code>()sortedArray</code> لترتيب عناصر مصفوفة تصاعديًّا:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]]<nowiki/>باسم <code>array</code> مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf‎</code>، ثم تستخدم الدالة<code>()sortedArray</code>  على <code>array</code> لترتيبه، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
import java.util.Arrays
 
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val array = arrayOf(1, 9, -3, 7, 5, 6)
    val array = arrayOf(1, 9, -3, 7, 5, 6)
   
 
      
     print(Arrays.toString(array.sortedArray())) // [-3, 1, 5, 6, 7, 9]
print (array.sorted()) // [-3, 1, 5, 6, 7, 9]ش
}
}
</syntaxhighlight>
</syntaxhighlight>
==أنظر أيضًا==
==انظر أيضًا==
*<code>[[Kotlin/collections/sortBy|sortBy()]]</code>‎ : تقوم بترتيب  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/MutableList|اللائحة المتغيرة]] (<code>MutableList</code>) التي استُدعيت عبرها وفقًا للقيم التي تعيدها الدالة المُمرّرة . 
*الدالة <code>[[Kotlin/collections/sorted|sorted()]]</code>‎: جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة.
 
*الدالة <code>[[Kotlin/collections/sortedArrayDescending|sortedArrayDescending()‎]]</code>: ترتِّب جميع عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في [[Kotlin/List|مصفوفة]] جديدة.
* <code>[[Kotlin/collections/sort|sort()]]</code>‎ : تقوم بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها.
*الدالة <code>[[Kotlin/collections/sortedArrayWith|sortedArrayWith()‎]]</code>: ترتِّب جميع عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في مصفوفة جديدة.
*الدالة <code>[[Kotlin/collections/sortedBy|sortedBy()]]</code>‎: عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر.
*الدالة <code>[[Kotlin/collections/sortedByDescending|sortedByDescending()‎]]</code>: ترتِّب جميع عناصر [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] (Iterable) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة. 
*الدالة <code>[[Kotlin/collections/sortedDescending|sortedDescending()‎]]</code>: ترتِّب جميع عناصر [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في [[Kotlin/List|قائمة]].
*الدالة <code>[[Kotlin/collections/sortedWith|sortedWith()‎]]</code>: ترتِّب جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في قائمة.
* الدالة <code>[[Kotlin/collections/sort|sort()]]</code>‎ : ترتب <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا.


==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted.html الدالة  sortedArray()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sorted-array.html صفحة الدالة sortedArray()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 11:13، 8 سبتمبر 2018

ترتِّب الدالة sortedArray()‎ جميع عناصر المصفوفة التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في مصفوفة جديدة. 

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

fun <T : Comparable<T>> Array<T>.sortedArray(): Array<T> 
fun ByteArray.sortedArray(): ByteArray 
fun ShortArray.sortedArray(): ShortArray 
fun IntArray.sortedArray(): IntArray 
fun LongArray.sortedArray(): LongArray 
fun FloatArray.sortedArray(): FloatArray 
fun DoubleArray.sortedArray(): DoubleArray 
fun CharArray.sortedArray(): CharArray

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

تعاد مصفوفة جديدة تضم عناصر المصفوفة المعطاة بعد ترتيبها تصاعديًّا.

أمثلة

استعمال الدالة ()sortedArray لترتيب عناصر مصفوفة تصاعديًّا:

import java.util.Arrays

fun main(args: Array<String>) {
    val array = arrayOf(1, 9, -3, 7, 5, 6)

    print(Arrays.toString(array.sortedArray())) // [-3, 1, 5, 6, 7, 9]
}

انظر أيضًا

  • الدالة sorted()‎: جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تصاعديًّا ثمَّ تضع الناتج في قائمة.
  • الدالة sortedArrayDescending()‎: ترتِّب جميع عناصر المصفوفة التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في مصفوفة جديدة.
  • الدالة sortedArrayWith()‎: ترتِّب جميع عناصر المصفوفة التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في مصفوفة جديدة.
  • الدالة sortedBy()‎: عناصر المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر.
  • الدالة sortedByDescending()‎: ترتِّب جميع عناصر المصفوفة أو المجموعة التكرارية (Iterable) التي استُدعيت معها تنازليًّا وفقًا للقيم التي تعيدها الدالة المُمرّرة إليها عند تطبيقها على كل عنصر ثمَّ تضع الناتج في قائمة. 
  • الدالة sortedDescending()‎: ترتِّب جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها تنازليًّا ثمَّ تضع الناتج في قائمة.
  • الدالة sortedWith()‎: ترتِّب جميع عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت معها وفقًا للمُقارِن المُمرّر إليها ثمَّ تضع الناتج في قائمة.
  • الدالة sort()‎ : ترتب المصفوفة أو القائمة المتغيرة (MutableList) التي استُدعيت معها تصاعديًّا.

مصادر

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