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

تعيد الدالة orEmpty()‎ السلسلة النصية التي استٌدعيت عبرها إن لم تكن معدومة (not-null)، وإلا فستعيد سلسلة نصية فارغة.

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

inline fun String?.orEmpty(): String

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

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

قيمة منطقية.

أمثلة

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

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

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

println(str.orEmpty()) // Hsoub
println(null.orEmpty()) // تعيد سلسلة نصية فارغة
}

انظر أيضًا

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

مصادر

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