الدالة take()
في لغة Kotlin
< Kotlin | collections
تعيد الدالةtake()
لائحة تضم n
من أولى العناصر الموجودة في المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.
البنية العامة
fun <T> Array<out T>.take(n: Int): List<T>
fun ByteArray.take(n: Int): List<Byte>
fun ShortArray.take(n: Int): List<Short>
fun IntArray.take(n: Int): List<Int>
fun LongArray.take(n: Int): List<Long>
fun FloatArray.take(n: Int): List<Float>
fun DoubleArray.take(n: Int): List<Double>
fun BooleanArray.take(n: Int): List<Boolean>
fun CharArray.take(n: Int): List<Char>
fun <T> Iterable<T>.take(n: Int): List<T>
يُلاحَظ وجود الكلمة المفتاحية inline
للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيمة المُعادة
لائحة تضم n
من العناصر الأولى الموجودة في المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.
أمثلة
استخدام الدالة ()take
مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم array
مكونة من ستة أعداد باستخدام الدالة ()arrayOf
، ثم تستخدم الدالة()take
على array
مع تمرير العدد 3
كوسيط، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(3, 5, 7, 2 , 6, 9)
println(array.take(3) )// [3, 5, 7]
}