Kotlin/collections/take

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

أنظر أيضًا

• sum()‎ : تعيد  مجموع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.

مصادر

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