الدالة text.offsetByCodePoints()
في لغة Kotlin
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
تعيد الدالة 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
والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.