Kotlin/collections/isEmpty

تتحقق الدالة isEmpty()‎ إن كانت المصفوفة التي استُدعيت معها فارغةً أم لا.

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

inline fun <T> Array<out T>.isEmpty(): Boolean 
inline fun ByteArray.isEmpty(): Boolean 
inline fun ShortArray.isEmpty(): Boolean 
inline fun IntArray.isEmpty(): Boolean 
inline fun LongArray.isEmpty(): Boolean 
inline fun FloatArray.isEmpty(): Boolean 
inline fun DoubleArray.isEmpty(): Boolean 
inline fun BooleanArray.isEmpty(): Boolean 
inline fun CharArray.isEmpty(): Boolean

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

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

تُعاد القيمة true إن كانت المصفوفة المعطاة فارغةً، أو القيمة false خلاف ذلك.

أمثلة

استخدام الدالة isEmpty()‎ مع مصفوفة غير فارغة

تعرف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()isEmpty للتحقُّق من أن المصفوفة تلك فارغةٌ أم لا:

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4, 5, 6)

    print(array.isEmpty()) // false
}

استخدام الدالة isEmpty()‎ مع مصفوفة فارغة

تعرِّف الشيفرة الآتية مصفوفة فارغة باسم array باستخدام الدالة ()emptyArray<String>‎ ثمَّ تستخدم الدالة ()isEmpty للتحقُّق من أنَّ المصفوفة تلك فارغةٌ أم لا:

fun main(args: Array<String>) {
    val array = emptyArray<String>()

    print(array.isEmpty()) // true
}

انظر أيضًا

• الدالة isNotEmpty()‎: تعيد القيمة true إن كانت المصفوفة التي استُدعيت عبرها غير فارغةً.
• الدالة orempty()‎: تعيد المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة null، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك.

• الدالة isArrayOf()‎: تتحقق من حواية المصفوفة التي استُدعيت معها عناصرَ من نوعٍ محدَّد.
• الدالة none()‎:تتحقق إن كانت المصفوفة أو المجموعة أو الخريطة التي استدعيت معها فارغةً، أو إن لم يكن هنالك أي عنصر من تلك العناصر محقِّقًا لشرط معين.
• الخاصية ‎‎Array.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.

مصادر

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