عرض مصدر Kotlin/collections/none

تتحقَّق الدالة <code>none()‎</code> إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة التي استدعيت معها فارغةً، أو إن لم يكن هنالك أي عنصر من تلك العناصر محقِّقًا لشرط معين.
==البنية العامة==
يمكن استدعاء الدالة <code>none()‎</code> مع المصفوفات والمجموعات والخرائط دون تمرير أية معامل إليها:<syntaxhighlight lang="kotlin">
fun <T> Array<out T>.none(): Boolean 
fun ByteArray.none(): Boolean 
fun ShortArray.none(): Boolean 
fun IntArray.none(): Boolean 
fun LongArray.none(): Boolean 
fun FloatArray.none(): Boolean 
fun DoubleArray.none(): Boolean 
fun BooleanArray.none(): Boolean 
fun CharArray.none(): Boolean

fun <T> Iterable<T>.none(): Boolean (source)

fun <K, V> Map<out K, V>.none(): Boolean (source)

</syntaxhighlight>ويمكن تمرير الدالة <code>predicate</code> التي تمثل شرطًا معيَّنًا إلى الدالة <code>none()‎</code> مع المصفوفات والخرائط:<syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.none(
    predicate: (T) -> Boolean
): Boolean 
inline fun ByteArray.none(
    predicate: (Byte) -> Boolean
): Boolean 
inline fun ShortArray.none(
    predicate: (Short) -> Boolean
): Boolean 
inline fun IntArray.none(
    predicate: (Int) -> Boolean
): Boolean 
inline fun LongArray.none(
    predicate: (Long) -> Boolean
): Boolean 
inline fun FloatArray.none(
    predicate: (Float) -> Boolean
): Boolean 
inline fun DoubleArray.none(
    predicate: (Double) -> Boolean
): Boolean 
inline fun BooleanArray.none(
    predicate: (Boolean) -> Boolean
): Boolean 
inline fun CharArray.none(
    predicate: (Char) -> Boolean
): Boolean 
inline fun <T> Iterable<T>.none(
    predicate: (T) -> Boolean
): Boolean 

inline fun <K, V> Map<out K, V>.none(
    predicate: (Entry<K, V>) -> Boolean
): Boolean (source)
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).

== المعاملات ==

=== <code>predicate</code> ===
دالة تطبق على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة المعطاة، إذ يمرر إليها العنصر ثم تعيد القيمة المنطقية المقابلة له.

==القيم المعادة==
تُعاد القيمة <code>true</code> إن كانت [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] أو الخريطة المعطاة فارغةً أو لم يكن هنالك أي عنصر من تلك العناصر متطابقًا مع الدالة <code>()predicate</code> (إن أعطيت). خلا ذلك، تُعاد القيمة <code>false</code>.
==أمثلة==
استعمال الدالة <code>()none</code> للتحقق من أنّ قائمةً ما فارغةٌ أم لا:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val emptyList = emptyList<Int>()

    println(emptyList.none()) // true
}
</syntaxhighlight>
استعمال الدالة <code>()none</code> للتحقق من عدم وجود أي عنصر في المصفوفة أصغر من 5:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val array = arrayOf(3, 7, 9)

    println(array.none { it < 5 }) // false
}
</syntaxhighlight>
==انظر أيضًا==
*الدالة <code>[[Kotlin/collections/orEmpty|orempty()]]</code>‎: تعيد المصفوفة أو المجموعة أو القائمة أو الخريطة التي استُدعيت معها إن لم تكن مساويةً للقيمة <code>null</code>، أو تعيد كائنًا فارغًا يقابل الكائن المعطى (مصفوفة فارغة، أو مجموعة فارغة ...إلخ.) خلاف ذلك.
* الدالة <code>[[Kotlin/collections/isEmpty|isEmpty()‎]]</code>: تتحقق إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها فارغةً أم لا.
* الدالة <code>[[Kotlin/jvm/isArrayOf|isArrayOf()‎]]</code>: تتحقق من حواية <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها عناصرَ من نوعٍ محدَّد.
* الدالة <code>[[Kotlin/collections/all|all()‎]]</code>: تتحقق إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت معها تطابق شرطًا محدَّدًا.
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/none.html صفحة الدالة none()‎ في التوثيق الرسمي للمكتبة القياسيّة في لغة Kotlin.]<noinclude>{{DISPLAYTITLE: الدالة <code>none()‎</code> في Kotlin}}</noinclude>
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]