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

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

تحذف الدالة distinct()‎ العناصر المتكررة الموجودة في المصفوفة أو المجموعة التي استُدعيت معها وتعيد الناتج في قائمة. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة.

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

تستدعى الدالة distinct()‎ مع مصفوفة:

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

وتستدعى مع مجموعة:

fun <T> Iterable<T>.distinct(): List<T>

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

تُعاد قائمة تحتوي على عناصر المصفوفة أو المجموعة التي استُدعيت معها بعد حذف العناصر المتكررة.

أمثلة

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

تعرِّف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثم تستخدم الدالة ()count لحذف العناصر المتكررة:

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 4, 5, 2, 6, 22)
    println(array.distinct()) // [1, 2, 3, 4, 5, 6, 22]
}

انظر أيضًا

الدالة distinctBy()‎: تعيد قائمة تحتوي على العناصر الموجودة في المصفوفة أو المجموعة التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق الدالة selector عليها فقط.
الدالة copyOf()‎: تنسخ الدالة كامل المصفوفة التي استُدعيت معها أو جزءًا منها.
الدالة drop()‎: تعيد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء أول n عنصر.
الدالة count()‎: تعيد عدد عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها.
الخاصية lastIndex: تجلب فهرس (index) العنصر الأخير في المصفوفة أو القائمة.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>distinct()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>distinct()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة<code>distinct()‎</code> [[Kotlin/List|لائحة]] تحتوي عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها بدون تكرار مع احترام ظهور تلك العناصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]].
+تحذف الدالة <code>distinct()‎</code> العناصر المتكررة الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها وتعيد الناتج في قائمة. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة.
 == البنية العامة ==
-استدعاء الدالة <code>distinct()‎</code> عبر  [[Kotlin/Array|مصفوفة]].<syntaxhighlight lang="kotlin">
+تستدعى الدالة <code>distinct()‎</code> مع [[Kotlin/Array|مصفوفة]]:<syntaxhighlight lang="kotlin">
 fun <T> Array<out T>.distinct(): List<T>
 fun ByteArray.distinct(): List<Byte>
@@ سطر 15: / سطر 15: @@
 </syntaxhighlight>
-في حال استدعاء الدالة <code>distinct()‎</code> عبر  [[Kotlin/collections|مجموعة]].<syntaxhighlight lang="kotlin">
+وتستدعى مع [[Kotlin/collections|مجموعة]]:<syntaxhighlight lang="kotlin">
 fun <T> Iterable<T>.distinct(): List<T>
@@ سطر 22: / سطر 22: @@
 == القيم المعادة ==
-[[Kotlin/List|لائحة]] تحتوي عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها بدون تكرار مع احترام ظهور تلك العناصر في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]].
+تُعاد [[Kotlin/List|قائمة]] تحتوي على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت معها بعد حذف العناصر المتكررة.
 ==أمثلة==
 ===استخدام الدالة <code>()distinct</code> مع المصفوفات  ===
-تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من تسعة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()count</code> للحصول على لائحة تضم العناصر غير المكررة لتلك [[Kotlin/Array|المصفوفة]] ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثم تستخدم الدالة <code>()count</code> لحذف العناصر المتكررة:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val array = arrayOf(1,2,3,4,4,5,2,6,22)
+    val array = arrayOf(1, 2, 3, 4, 4, 5, 2, 6, 22)
-println(array.distinct()) // [1, 2, 3, 4, 5, 6, 22]
+    println(array.distinct()) // [1, 2, 3, 4, 5, 6, 22]
 }
 </syntaxhighlight>
 ==انظر أيضًا  ==
-* صفحة [[Kotlin/Array|المصفوفات]] (Arrays).
+* الدالة <code>[[Kotlin/collections/distinctBy|distinctBy()‎]]</code>: تعيد [[Kotlin/List|قائمة]] تحتوي على العناصر الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق الدالة <code>selector</code> عليها فقط.
-* صفحة [[Kotlin/Array|المجموعات]] (Collections).
+* الدالة <code>[[Kotlin/collections/copyOf|copyOf()]]</code>‎: تنسخ الدالة كامل المصفوفة التي استُدعيت معها أو جزءًا منها.
+* الدالة <code>[[Kotlin/collections/drop|drop()‎]]</code>: تعيد [[Kotlin/List|قائمة]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء أول <code>n</code> عنصر.
-* <code>[[Kotlin/collections/count|count()]]</code>‎: تعيد عدد عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] أو [[Kotlin/Array|القاموس]] التي استُدعيت عبرها.
+* الدالة <code>[[Kotlin/collections/count|count()]]</code>‎: تعيد عدد عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها.
+* الخاصية <code>[[Kotlin/collections/lastIndex|lastIndex]]</code>: تجلب فهرس (index) العنصر الأخير في المصفوفة أو القائمة.
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/distinct.html الدالة  distinct()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/distinct.html صفحة الدالة distinct()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]