الفرق بين المراجعتين ل"Kotlin/collections/isEmpty"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق.)
سطر 1: سطر 1:
تعيد الدالة <code>isEmpty()‎</code> القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها فارغةً.
+
<noinclude>{{DISPLAYTITLE: الدالة <code>isEmpty()‎</code> في Kotlin}}</noinclude>
 +
تتحقق الدالة <code>isEmpty()‎</code> إن كانت [[Kotlin/Array|المصفوفة]] التي استُدعيت معها فارغةً أم لا.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
سطر 11: سطر 12:
 
inline fun BooleanArray.isEmpty(): Boolean  
 
inline fun BooleanArray.isEmpty(): Boolean  
 
inline fun CharArray.isEmpty(): Boolean  
 
inline fun CharArray.isEmpty(): Boolean  
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
 
==القيم المعادة==
 
==القيم المعادة==
القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها فارغةً.
+
تُعاد القيمة <code>true</code> إن كانت المصفوفة المعطاة فارغةً، أو القيمة <code>false</code> خلاف ذلك.
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة<code>isEmpty()‎</code> على مصفوفة: الحالة الأولى===
+
===استخدام الدالة <code>isEmpty()‎</code> مع مصفوفة غير فارغة===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()isEmpty</code>  للتحقق من أنّ المصفوفة <code>array</code>  فارغة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()isEmpty</code> للتحقُّق من أن المصفوفة تلك فارغةٌ أم لا:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
     val array = arrayOf(1,2,3,4,5,6)
+
     val array = arrayOf(1, 2, 3, 4, 5, 6)
  
 
     print(array.isEmpty()) // false
 
     print(array.isEmpty()) // false
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
===استخدام الدالة<code>isEmpty()‎</code> على مصفوفة: الحالة الثانية===
+
===استخدام الدالة <code>isEmpty()‎</code> مع مصفوفة فارغة===
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] فارغة باسم <code>array</code>  باستخدام الدالة <code>()emptyArray<String>‎</code>، ثم تستخدم الدالة  <code>()isEmpty</code>  لللتحقق من أنّ المصفوفة <code>array</code>  فارغة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+
تعرِّف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] فارغة باسم <code>array</code> باستخدام الدالة <code>()emptyArray<String>‎</code> ثمَّ تستخدم الدالة <code>()isEmpty</code> للتحقُّق من أنَّ المصفوفة تلك فارغةٌ أم لا:<syntaxhighlight lang="kotlin">
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
     val array = emptyArray<String>()  
+
     val array = emptyArray<String>()
  
 
     print(array.isEmpty()) // true
 
     print(array.isEmpty()) // true
سطر 32: سطر 33:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
* <code>[[Kotlin/collections/isNotEmpty|isNotEmpty]]()‎</code>: تعيد القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها غير فارغةً.
+
* الدالة <code>[[Kotlin/collections/isNotEmpty|isNotEmpty()]]‎</code>: تعيد القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها غير فارغةً.
  
*<code>[[Kotlin/jvm/isArrayOf|isArrayOf]]()‎</code>: تتحقق من أنّ <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها يمكن أن تحتوي عناصر من النوع المحدد.
+
*الدالة <code>[[Kotlin/jvm/isArrayOf|isArrayOf()‎]]</code>: تتحقق من حواية [[Kotlin/Array|المصفوفة]] التي استُدعيت معها عناصرَ من نوعٍ محدَّد.
 +
*الخاصية <code>‎‎[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
 
==مصادر==
 
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/is-empty.html الدالة isEmpty()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/is-empty.html صفحة الدالة isEmpty()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Methods]]
 
[[تصنيف:Kotlin Methods]]

مراجعة 14:11، 24 يوليو 2018

تتحقق الدالة 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 إن كانت المصفوفة التي استُدعيت عبرها غير فارغةً.
  • الدالة isArrayOf()‎: تتحقق من حواية المصفوفة التي استُدعيت معها عناصرَ من نوعٍ محدَّد.
  • الخاصية ‎‎Array.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.

مصادر