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

تعيد الدالة isNullOrBlank()‎ القيمة true في حال كانت سلسلة الحروف التي استٌدعيت عبرها تساوي null أو تتكوّن حصريا من مسافات بيضاء (whitespace characters).

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

inline fun CharSequence?.isNullOrBlank(): Boolean

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

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

قيمة منطقية.

أمثلة

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

تُعرّف الشيفرة الآتية ثلاث سلاسل نصية باسماء str و str2 و str3، ثم تستدعي الدالة isNullOrBlank()‎ عبرها، ثم تطبع الناتج:

fun main(args: Array<String>) {    
    val str = "hsoub"    
    val str2 = null
    val str3 = "   "
    
    print(str.isNullOrBlank()) // false
    print(str2.isNullOrBlank()) // true
    print(str3.isNullOrBlank()) // true

}

انظر أيضًا

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

مصادر

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