التابع text.isHighSurrogate()‎ في لغة Kotlin

تعيد الدالة isHighSurrogate()‎ القيمة true في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا (Unicode high-surrogate code unit).

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

inline actual fun Char.isHighSurrogate(): Boolean

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

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

قيمة منطقية.

أمثلة

استخدام الدالة isHighSurrogate()‎ مع الحروف

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

fun main(args: Array<String>) {    
    val x = 'a' 
    val y = '\uD800'
    
    print(x.isHighSurrogate()) // false
    print(y.isHighSurrogate()) // true
}

انظر أيضًا

• equals()‎: تعيد القيمة true في حال كان الحرف أو السلسلة النصية التي استُدعيت عبرها مساوية للحرف أو السلسلة النصية المُمرّرة إليها. في حال تمرير الوسيط ignoreCase وإعطائه القيمة true فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط ignoreCase هيfalse.
• isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

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