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

مراجعة 18:13، 27 مايو 2018

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

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

يمكن استدعاء الدالة 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

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

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

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

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

القيمة true إن كانت المصفوفة التي استُدعيت عبرها غير فارغةً.

أمثلة

استخدام الدالة`isNotEmpty()‎` على مصفوفة: الحالة الأولى

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

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

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

استخدام الدالة`isNotEmpty()‎` على مصفوفة: الحالة الثانية

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

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

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

انظر أيضًا

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

مصادر

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

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