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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>drop()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>drop()‎</code> لائحة ت...'
 
طلا ملخص تعديل
 
(6 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 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>
</syntaxhighlight>


في حال استدعاء الدالة <code>distinctBy()‎</code> عبر  [[Kotlin/collections|مجموعة]].<syntaxhighlight lang="kotlin">
== المعاملات ==
inline fun <T, K> Iterable<T>.distinctBy(
 
    selector: (T) -> K
=== <code>n</code> ===
): List<T>
عدد صحيح يمثل عدد العناصر المراد حذفها من بداية [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Array|المجموعة]] المعطاة.
</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> لحذف أول عنصرين من عناصر هذه المصفوفة:<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.distinctBy(selector)) // [1, 2, 3, 4, 5, 6, 22]
    println(array.drop(2)) // [3, 4]
}
}
</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/dropLast|dropLast()]]</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/dropWhile|dropWhile()]]</code>‎: تعيد [[Kotlin/List|قائمةً]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا.
*الدالة <code>[[Kotlin/collections/dropLastWhile|dropLastWhile()]]</code>‎: تعيد [[Kotlin/List|قائمةً]] تحوي جميع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.
* الدالة <code>[[Kotlin/collections/distinct|distinct()‎]]</code>: تحذف العناصر المتكررة الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها وتعيد الناتج في قائمة.
* الدالة <code>[[Kotlin/collections/elementAt|elementAt()‎]]</code>: تعيد العنصر الموجود عند فهرس معين في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها.


==مصادر==
==مصادر==
*[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 Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 07:44، 8 سبتمبر 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

عدد صحيح يمثل عدد العناصر المراد حذفها من بداية المصفوفة أو المجموعة المعطاة.

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

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

أمثلة

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

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

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

انظر أيضًا

مصادر

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