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>

المعاملات

n

عدد صحيح يمثل عدد العناصر الأولى المراد جلبها من المصفوفة أو المجموعة التكرارية المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول المصفوفة أو المجموعة التكرارية، فستعاد كل العناصر الموجودة في المصفوفة أو المجموعة التكرارية آنذاك.

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

تعاد قائمة تحوي أول n من عناصر المصفوفة أو المجموعة التكرارية المعطاة.

أمثلة

استعمال الدالة ()take لجلب أول ثلاثة عناصر من قائمة:

fun main(args: Array<String>) {
    val chars = ('a'..'z').toList()
    println(chars.take(3)) // [a, b, c]
}

انظر أيضًا

• الدالة first()‎: تجلب أول عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
• الدالة takeLast()‎: تجلب آخر n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة.
• الدالة takeWhile()‎: تجلب أول عناصر محققة لشرطٍ محدَّدٍ من المصفوفة أو القائمة التي استُدعيت معها.
• الدالة takeLastWhile()‎: تجلب آخر عناصر محققة لشرطٍ محدَّدٍ من المصفوفة أو القائمة التي استُدعيت معها.
• الدالة indexOf()‎: تجلب فهرس أول ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.
• الدالة find()‎: تبحث على عنصر محدَّد ضمن عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد أول ظهور له.
• الدالة filter()‎: ترشِّح عناصر المصفوفة أو المجموعة أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها.

مصادر

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