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