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

تعيد الدالة offsetByCodePoints()‎ الفهرس في السلسلة النصية التي استٌدعيت عبرها والذي يكون إزاحة (offset) من الوسيط index عبر كود اليونيكود (Unicode code point)المُمرّر codePointOffset.

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

inline fun String.offsetByCodePoints(
    index: Int, 
    codePointOffset: Int
): Int

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

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

عدد من النوع Int.

أمثلة

استخدام الدالة ()offsetByCodePoints مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()offsetByCodePoints عبرها مع تمرير عددين كوسيطين، ثمَّ تطبع الناتج:

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

print(str.offsetByCodePoints(0, 4)) // 4
}

انظر أيضًا

• codePointBefore()‎: تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد. 

• associateByTo()‎: تعيد قاموسا متغيرا (mutable map) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر سلسلة الحروف التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة keySelector. 
• asSequence()‎: تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

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