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

تجلب الدالة take()‎ أول n محرف من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.

البنية العامة

fun CharSequence.take(n: Int): CharSequence 

fun String.take(n: Int): String

المعاملات

n

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

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

تعاد سلسلة من المحارف أو سلسلة نصية تحوي أول n محرف من سلسلة المحارف أو السلسلة النصية المعطاة.

أمثلة

مثالٌ على استعمال الدالة ()take:

fun main(args: Array<String>) {
    val str = "wiki.hsoub.com"

    println(str.take(8))  // wiki.hso
    println(str.take(15)) // wiki.hsoub.com
}

انظر أيضًا

• الدالة takeLast()‎: تجلب آخر n محرف من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.
• الدالة takeWhile()‎: تجلب أول عناصر محققة لشرطٍ محدَّدٍ من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.
• الدالة takeLastWhile()‎: تجلب آخر عناصر محققة لشرطٍ محدَّدٍ من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.    
• الدالة subSequence()‎ : تعيد جزءًا محددًا من سلسلة المحارف التي استُدعيت معها.
• الدالة substring()‎: تعيد جزءًا محددًا من السلسلة النصية أو سلسلة المحارف التي استُدعيت معها. 
• الدالة slice()‎: تقتطع جزءًا محدَّدًا من سلسلة المحارف أو السلسلة النصية  التي استُدعيت معها ثمَّ تعيده.
• الدالة substringAfter()‎: تجلب كل الجزء الواقع بعد أول ظهور لمحرف أو لسلسلة نصية معينة في سلسلة نصية.

مصادر

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