الدالة text.indices()‎ في لغة Kotlin

تضم الدالة indices()‎ الحرف الذي استٌدعيت عبره إلى السلسلة النصية المُمرّرة إليها.

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

inline operator fun Char.plus(other: String): String

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

ويُلاحظ وجود الكلمة المفتاحيّة operator للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).

تُعرّف الشيفرة الآتية حرفًا باسم x وسلسلة نصية باسم y ثم تستدعي الدالة indices()‎ عبر x وتمرر إليها y، ثم تطبع الناتج:

fun main(args: Array<String>) {    
    val x = 'h' 
    val y = "soub"
    
	print(x.plus(y)) // hsoub
}

compareTo()‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .

dec()‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
inc()‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).