التابع isNullOrBlank()‎ في Kotlin

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

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

inline fun CharSequence?.isNullOrBlank(): Boolean

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

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

تعاد القيمة true إن كانت سلسلة المحارف المعطاة تساوي null أو تحوي محارف المسافات البيضاء فقط، أو تعاد القيمة false خلاف ذلك.

أمثلة

مثالٌ على استعمال الدالة 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
}

انظر أيضًا

• الدالة isBlank()‎ إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.
• الدالة isEmpty()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً.
• الدالة isNotBlank()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها غير فارغة وتحوي على الأقل محرفًا واحدًا غير محارف المسافة البيضاء (whitespace characters).
• الدالة isNotEmpty()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها غير فارغة.
• الدالة isNullOrEmpty()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها تساوي null أو كانت فارغةً.

• الدالة isLetter()‎: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
• الدالة isWhitespace()‎: تتحقق إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء (whitespace).

مصادر

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