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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>drop()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>drop()‎</code> لائحة ت...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>drop()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>drop()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة<code>drop()‎</code> [[Kotlin/List|لائحة]] تحتوي عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها والتي تختلف نتائج تطبيق الدالة (<code>selector</code>) عليها، ومع احترام ظهور تلك العناصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو<nowiki/>[[Kotlin/Array|المجموعة]].
تعيد الدالة<code>drop()‎</code> [[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأولى المحددة بالمعامل المُمرّر <code>n</code>.


== البنية العامة ==
== البنية العامة ==
استدعاء الدالة <code>distinctBy()‎</code> عبر  [[Kotlin/Array|مصفوفة]].<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline fun <T, K> Array<out T>.distinctBy(
fun <T> Array<out T>.drop(n: Int): List<T>  
    selector: (T) -> K
fun ByteArray.drop(n: Int): List<Byte>  
): List<T>  
fun ShortArray.drop(n: Int): List<Short>  
inline fun <K> ByteArray.distinctBy(
fun IntArray.drop(n: Int): List<Int>  
    selector: (Byte) -> K
fun LongArray.drop(n: Int): List<Long>  
): List<Byte>  
fun FloatArray.drop(n: Int): List<Float>
inline fun <K> ShortArray.distinctBy(
fun DoubleArray.drop(n: Int): List<Double>  
    selector: (Short) -> K
fun BooleanArray.drop(n: Int): List<Boolean>  
): List<Short>  
fun CharArray.drop(n: Int): List<Char>  
inline fun <K> IntArray.distinctBy(
fun <T> Iterable<T>.drop(n: Int): List<T>  
    selector: (Int) -> K
): List<Int>  
inline fun <K> LongArray.distinctBy(
    selector: (Long) -> K
): List<Long>  
inline fun <K> FloatArray.distinctBy(
    selector: (Float) -> K
): List<Float>  
inline fun <K> DoubleArray.distinctBy(
    selector: (Double) -> K
): List<Double>
inline fun <K> BooleanArray.distinctBy(
    selector: (Boolean) -> K
): List<Boolean>
inline fun <K> CharArray.distinctBy(
    selector: (Char) -> K
): List<Char>  


</syntaxhighlight>
في حال استدعاء الدالة <code>distinctBy()‎</code> عبر  [[Kotlin/collections|مجموعة]].<syntaxhighlight lang="kotlin">
inline fun <T, K> Iterable<T>.distinctBy(
    selector: (T) -> K
): List<T>
</syntaxhighlight>
</syntaxhighlight>


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


[[Kotlin/List|لائحة]] تحتوي عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها والتي تختلف نتائج تطبيق دالة (<code>selector</code>) عليها.
[[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] باستثناء العناصر الأولى المحددة بالمعامل المُمرّر <code>n</code>.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()drop</code> مع المصفوفات: الحالة الأولى ===
===استخدام الدالة <code>()drop</code> مع المصفوفات  ===
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من تسعة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تعرف دالة باسم <code>()selector</code>، ثم تستخدم الدالة <code>()drop</code> للحصول على لائحة تضم العناصر التي تختلف نتائج تطبيق الدالة <code>()selector</code>عليها، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من أربعة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()drop</code> للحصول على لائحة تضم عناصر المصفوفة انطلاقًا من الفهرس <code>2</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,4,5,2,6,22)
val selector: (Int) -> Int = {it+ 10}
println(array.distinctBy(selector)) // [1, 2, 3, 4, 5, 6, 22]
}
</syntaxhighlight>
===استخدام الدالة <code>()drop</code> مع المصفوفات: الحالة الثانية  ===
تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من تسعة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تعرف دالة باسم <code>()selector</code>، ثم تستخدم الدالة <code>()drop</code> للحصول على لائحة تضم العناصر التي تختلف نتائج تطبيق الدالة <code>()selector</code>عليها، ولأنّ الدالة <code>()selector</code> ستعيد نفس القيمة (<code>0</code>) على كل العناصر،  فستعيد الدالة <code>()distinctBy</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)
val selector: (Int) -> Int = {it*0}
println(array.drop(2)) // [3, 4]
println(array.distinctBy(selector)) // [1, 2, 3, 4, 5, 6, 22]
}
}
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا  ==
==انظر أيضًا  ==
* <code>[[Kotlin/collections/distinct|distinct()]]</code>‎: تعيد  <nowiki/>[[Kotlin/List|لائحة]] تحتوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت عبرها بدون تكرار مع احترام ظهور تلك العناصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو<nowiki/>[[Kotlin/Array|المجموعة]].
* <code>[[Kotlin/collections/dropWhile|dropWhile()]]</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/dropLastWhile|dropLastWhile()]]</code>‎: تعيد [[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأخيرة المحددة بالمعامل المُمرّر <code>n</code>والتي تحقق شرطا منطقيا محددًا.
* <code>[[Kotlin/collections/dropLast|dropLast()]]</code>‎: تعيد [[Kotlin/List|لائحة]] تحتوي جميع عناصر  [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] التي استُدعيت عبرها باستثناء العناصر الأخيرة المحددة بالمعامل المُمرّر <code>n</code>.


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

مراجعة 18:00، 13 مايو 2018

تعيد الدالةdrop()‎ لائحة تحتوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها باستثناء العناصر الأولى المحددة بالمعامل المُمرّر n.

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

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

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

لائحة تحتوي جميع عناصر المصفوفة أو المجموعة باستثناء العناصر الأولى المحددة بالمعامل المُمرّر n.

أمثلة

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

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من أربعة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()drop للحصول على لائحة تضم عناصر المصفوفة انطلاقًا من الفهرس 2، ثم تطبع الناتج:

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

انظر أيضًا

  • dropWhile()‎: تعيد لائحة تحتوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها باستثناء العناصر الأولى المحددة بالمعامل المُمرّر nوالتي تحقق شرطا منطقيا محددًا.
  • dropLastWhile()‎: تعيد لائحة تحتوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها باستثناء العناصر الأخيرة المحددة بالمعامل المُمرّر nوالتي تحقق شرطا منطقيا محددًا.
  • dropLast()‎: تعيد لائحة تحتوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها باستثناء العناصر الأخيرة المحددة بالمعامل المُمرّر n.

مصادر