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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة isEmpty()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>isEmpty()‎</code> فهرس أول ظهور للعنص...')
 
سطر 1: سطر 1:
−
<noinclude>{{DISPLAYTITLE: الدالة isEmpty()‎ في لغة Kotlin}}</noinclude>
+
تعيد الدالة <code>isEmpty()‎</code> القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها فارغةً.
−
تعيد الدالة <code>isEmpty()‎</code> فهرس أول ظهور للعنصر المُمرّر إليها في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر <code>predicate</code>، أو ‎<code>-1‎</code> إن لم يكن هناك أي عنصر يحقق ذلك.
+
==البنية العامة==
−
== البنية العامة ==
+
<syntaxhighlight lang="kotlin">
−
يمكن استدعاء  الدالة <code>indexOfFirst()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<syntaxhighlight lang="kotlin">
+
inline fun <T> Array<out T>.isEmpty(): Boolean  
−
inline fun <T> Array<out T>.indexOfFirst(
+
inline fun ByteArray.isEmpty(): Boolean  
−
    predicate: (T) -> Boolean
+
inline fun ShortArray.isEmpty(): Boolean  
−
): Int
+
inline fun IntArray.isEmpty(): Boolean  
−
inline fun ByteArray.indexOfFirst(
+
inline fun LongArray.isEmpty(): Boolean  
−
    predicate: (Byte) -> Boolean
+
inline fun FloatArray.isEmpty(): Boolean  
−
): Int
+
inline fun DoubleArray.isEmpty(): Boolean  
−
inline fun ShortArray.indexOfFirst(
+
inline fun BooleanArray.isEmpty(): Boolean  
−
    predicate: (Short) -> Boolean
+
inline fun CharArray.isEmpty(): Boolean  
−
): Int
 
−
inline fun IntArray.indexOfFirst(
 
−
    predicate: (Int) -> Boolean
 
−
): Int
 
−
inline fun LongArray.indexOfFirst(
 
−
    predicate: (Long) -> Boolean
 
−
): 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)]].
 
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
−
 
+
==القيم المعادة==
−
== القيم المعادة ==
+
القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها فارغةً.
−
فهرس أول ظهور للعنصر المُمرّر إلى الدالة <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>array</code>  فارغة، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
−
=== استخدام الدالة<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>) {
 
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.indexOfFirst { it > 2 }) // 2
+
     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>()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 array = emptyArray<String>()  
  
−
     print(array.indexOfFirst { it > 8 }) // -1
+
     print(array.isEmpty()) // true
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
−
== انظر أيضًا ==
+
==انظر أيضًا==
−
* <code>[[Kotlin/collections/indexOf|indexOf]]()‎</code>: تعيد فهرس أول ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو <nowiki/>[[Kotlin/List|اللائحة]] التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
+
*<code>[[Kotlin/jvm/isArrayOf|isArrayOf]]()‎</code>: تتحقق من أنّ <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها يمكن أن تحتوي عناصر من النوع المحدد.
−
 
+
==مصادر==
−
== مصادر ==
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/is-empty.html الدالة isEmpty()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
−
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index-of-first.html الدالة isEmpty()‎  في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.]
 
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Methods]]
 
[[تصنيف:Kotlin Methods]]

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

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

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

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 إن كانت المصفوفة التي استُدعيت عبرها فارغةً.

أمثلة

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

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

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

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

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

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

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

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

انظر أيضًا

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

مصادر

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