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

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


== مصادر ==
*الدالة <code>[[Kotlin/jvm/isArrayOf|isArrayOf()‎]]</code>: تتحقق من حواية [[Kotlin/Array|المصفوفة]] التي استُدعيت معها عناصرَ من نوعٍ محدَّد.
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of-first.html الدالة isEmpty()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
* الدالة <code>[[Kotlin/collections/none|none()]]</code>‎:تتحقق إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو الخريطة التي استدعيت معها فارغةً، أو إن لم يكن هنالك أي عنصر من تلك العناصر محقِّقًا لشرط معين.
*الخاصية <code>‎‎[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/is-empty.html صفحة الدالة isEmpty()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

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

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

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

انظر أيضًا

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

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/collections/isEmpty&oldid=17135»