الفرق بين المراجعتين لصفحة: «Kotlin/collections/isNotEmpty»

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

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

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

يمكن استدعاء الدالة isNotEmpty()‎ مع المصفوفات والمجموعات:

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

inline fun <T> Collection<T>.isNotEmpty(): Boolean

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

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

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

أمثلة

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

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

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

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

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

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

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

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

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>isNotEmpty()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>isNotEmpty()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>isNotEmpty()‎</code> القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها غير فارغةً.
+تتحقَّق الدالة <code>isNotEmpty()‎</code> إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها فارغةً أم لا. تعمل هذه الدالة بشكل معاكس للدالة <code>[[Kotlin/collections/isEmpty|isEmpty()‎]]</code>.
 ==البنية العامة==
-يمكن استدعاء الدالة <code>isNotEmpty()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
+يمكن استدعاء الدالة <code>isNotEmpty()‎</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
 inline fun <T> Array<out T>.isNotEmpty(): Boolean
 inline fun ByteArray.isNotEmpty(): Boolean
@@ سطر 13: / سطر 13: @@
 inline fun CharArray.isNotEmpty(): Boolean
-</syntaxhighlight>يمكن استدعاء الدالة <code>isNotEmpty()‎</code> عبر [[Kotlin/collections|المجموعات]]:
-<syntaxhighlight lang="kotlin">
 inline fun <T> Collection<T>.isNotEmpty(): Boolean
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المعادة==
-القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها غير فارغةً.
+تُعاد القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة غير فارغة، أو القيمة <code>false</code> خلاف ذلك.
 ==أمثلة==
-===استخدام الدالة<code>isNotEmpty()‎</code> على مصفوفة: الحالة الأولى===
+===استخدام الدالة <code>isNotEmpty()‎</code> مع مصفوفة غير فارغة===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة  <code>()isNotEmpty</code>  للتحقق من أنّ المصفوفة <code>array</code> غير فارغة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()isNotEmpty</code>  للتحقُّق من أنَّ المصفوفة تلك فارغةٌ أم لا:<syntaxhighlight lang="kotlin">
 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.isNotEmpty()) // true
 }
 </syntaxhighlight>
-===استخدام الدالة<code>isNotEmpty()‎</code> على مصفوفة: الحالة الثانية===
+===استخدام الدالة <code>isNotEmpty()‎</code> مع مصفوفة فارغة===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] فارغة باسم <code>array</code>  باستخدام الدالة <code>()emptyArray<String>‎</code>، ثم تستخدم الدالة  <code>()isNotEmpty</code> لللتحقق من أنّ المصفوفة <code>array</code> غير فارغة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] فارغة باسم <code>array</code>  باستخدام الدالة <code>()emptyArray<String>‎</code> ثمَّ تستخدم الدالة <code>()isNotEmpty</code> للتحقّق من أنَّ المصفوفة تلك فارغةٌ أم لا:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val array = emptyArray<String>()
@@ سطر 38: / سطر 35: @@
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/collections/isEmpty|isEmpty]]()‎</code>: تعيد القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها فارغةً.
+*الدالة <code>[[Kotlin/collections/isEmpty|isEmpty()‎]]</code>: تتحقق إن كانت [[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-not-empty.html الدالة isNotEmpty()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Methods]]