الدالة drop()‎ في Kotlin

تعيد الدالة 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]
}

انظر أيضًا

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

مصادر

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