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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>isNotEmpty()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة <code>isNotEmpty()‎</code> القيمة <co...'
 
طلا ملخص تعديل
 
(7 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>isNotEmpty()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>isNotEmpty()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>isNotEmpty()‎</code> القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها فارغةً.
تتحقَّق الدالة <code>isNotEmpty()‎</code> إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها فارغةً أم لا. تعمل هذه الدالة بشكل معاكس للدالة <code>[[Kotlin/collections/isEmpty|isEmpty()‎]]</code>.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
يمكن استدعاء الدالة <code>isNotEmpty()‎</code> مع [[Kotlin/Array|المصفوفات]] و<nowiki/>[[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.isEmpty(): Boolean  
inline fun <T> Array<out T>.isNotEmpty(): Boolean  
inline fun ByteArray.isEmpty(): Boolean  
inline fun ByteArray.isNotEmpty(): Boolean  
inline fun ShortArray.isEmpty(): Boolean  
inline fun ShortArray.isNotEmpty(): Boolean  
inline fun IntArray.isEmpty(): Boolean  
inline fun IntArray.isNotEmpty(): Boolean  
inline fun LongArray.isEmpty(): Boolean  
inline fun LongArray.isNotEmpty(): Boolean  
inline fun FloatArray.isEmpty(): Boolean  
inline fun FloatArray.isNotEmpty(): Boolean
inline fun DoubleArray.isEmpty(): Boolean  
inline fun DoubleArray.isNotEmpty(): Boolean  
inline fun BooleanArray.isEmpty(): Boolean  
inline fun BooleanArray.isNotEmpty(): Boolean  
inline fun CharArray.isEmpty(): Boolean  
inline fun CharArray.isNotEmpty(): Boolean
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
inline fun <T> Collection<T>.isNotEmpty(): Boolean  
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
==القيم المعادة==
==القيم المعادة==
القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها فارغةً.
تُعاد القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] المعطاة غير فارغة، أو القيمة <code>false</code> خلاف ذلك.
==أمثلة==
==أمثلة==
===استخدام الدالة<code>isNotEmpty()‎</code> على مصفوفة: الحالة الأولى===
مثالٌ<nowiki/> على استعمال الدالة <code>()isNotEmpty</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>) {
fun main(args: Array<String>) {
     val array = arrayOf(1,2,3,4,5,6)
     val array1 = arrayOf(1, 2, 3, 4, 5, 6)
    val array2 = emptyArray<String>()  


     print(array.isEmpty()) // false
     print(array1.isNotEmpty()) // true
    print(array2.isNotEmpty()) // false
}
}
</syntaxhighlight>
</syntaxhighlight>
===استخدام الدالة<code>isNotEmpty()‎</code> على مصفوفة: الحالة الثانية===
==<nowiki/>انظر أيضًا==
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]] فارغة باسم <code>array</code>  باستخدام الدالة <code>()emptyArray<String>‎</code>، ثم تستخدم الدالة  <code>()isNotEmpty</code>  لللتحقق من أنّ المصفوفة <code>array</code>  فارغة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
*الدالة <code>[[Kotlin/collections/isEmpty|isEmpty()‎]]</code>: تتحقق إن كانت [[Kotlin/Array|المصفوفة]] التي استُدعيت معها فارغةً أم لا.
fun main(args: Array<String>) {
* الدالة <code>[[Kotlin/collections/orEmpty|orempty()]]</code>‎: تعيد المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة <code>null</code>، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك.
    val array = emptyArray<String>()
* الدالة <code>[[Kotlin/collections/none|none()]]</code>‎: تتحقق إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استدعيت معها فارغةً، أو إن لم يكن هنالك أي عنصر من تلك العناصر محقِّقًا لشرط معين.
*الدالة <code>[[Kotlin/jvm/isArrayOf|isArrayOf()‎]]</code>: تتحقق من حواية [[Kotlin/Array|المصفوفة]] التي استُدعيت معها عناصرَ من نوعٍ محدَّد.
*الخاصية <code>‎‎[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.


    print(array.isEmpty()) // true
}
</syntaxhighlight>
==انظر أيضًا==
*<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]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 08:37، 8 سبتمبر 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:

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

    print(array1.isNotEmpty()) // true
    print(array2.isNotEmpty()) // false
}

انظر أيضًا

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

مصادر