الدالة CharSequence.elementAt()‎ في Kotlin

تجلب الدالة elementAt()‎ محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها. إن كان فهرس المحرف المعطى خارج حدود سلسلة المحارف، فستُطلق الدالة الاستثناءIndexOutOfBoundsException.

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

inline fun CharSequence.elementAt(index: Int): Char

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع توثيق الدوال المباشرة).

المعاملات

index

عدد صحيح يمثل فهرس المحرف المراد جلبه من سلسلة المحارف المعطاة.

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

يُعاد المحرف ذي الفهرس المعطى والموجود ضمن نطاق سلسلة المحارف المعطاة، أو يُطلَق الاستثناء IndexOutOfBoundsException إن كان فهرس العنصر المعطى يقع خارج حدود سلسلة المحارف.

أمثلة

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

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

    println(str.elementAt(2)) // k
}

انظر أيضًا

• الدالة elementAtOrElse()‎: تجلب محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها.
• الدالة elementAtOrNull()‎: تجلب محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها.
• الدالة first()‎: تجلب أول محرف من محارف السلسلة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
• الدالة drop()‎: تُزيِل أول n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها. 

مصادر

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