الدالة `filterNot()‎` في لغة Kotlin

تعيد الدالةfilterNot()‎ لائحة تحتوي عناصر المصفوفة أو المجموعة التي لا تحقق الشرط المنطقي predicate()‎ المُمرّر إلى الدالة. وفي حال استدعائها عبر قاموس فستعيد قاموسًا جديدًا مكونًا من كل الأزوج التي لا تحقق الشرط المنطقي predicate()‎ الممرر إلى الدالة، هذا القاموسالجديد يحافظ على ترتيب تكرار (entry iteration order) القاموسالأصلي.

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

يمكن استدعاء الدالةfilterNot()‎ على المصفوفات أو المجموعات.

inline fun <T> Array<out T>.filterNot(
    predicate: (T) -> Boolean
): List<T> 
inline fun ByteArray.filterNot(
    predicate: (Byte) -> Boolean
): List<Byte> 
inline fun ShortArray.filterNot(
    predicate: (Short) -> Boolean
): List<Short> 
inline fun IntArray.filterNot(
    predicate: (Int) -> Boolean
): List<Int> 
inline fun LongArray.filterNot(
    predicate: (Long) -> Boolean
): List<Long> 
inline fun FloatArray.filterNot(
    predicate: (Float) -> Boolean
): List<Float> 
inline fun DoubleArray.filterNot(
    predicate: (Double) -> Boolean
): List<Double> 
inline fun BooleanArray.filterNot(
    predicate: (Boolean) -> Boolean
): List<Boolean> 
inline fun CharArray.filterNot(
    predicate: (Char) -> Boolean
): List<Char> 
inline fun <T> Iterable<T>.filterNot(
    predicate: (T) -> Boolean
): List<T>

يمكن استدعاء الدالةfilterNot()‎ على القواميس.

inline fun <K, V> Map<out K, V>.filterNot(
    predicate: (Entry<K, V>) -> Boolean
): Map<K, V>

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

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

لائحة تحتوي عناصر المصفوفة أو المجموعة التي لا تحقق الشرط المنطقي predicate()‎ المُمرّر إلى الدالة. وفي حال استدعائها عبر قاموس فستعيد قاموسًا جديدًا مكونًا من كل الأزوج التي لا تحقق الشرط المنطقي predicate()‎ الممرر إلى الدالة.

أمثلة

استخدام الدالة `()filterNot` مع المصفوفات

تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة أعداد باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()filterNot لتصفية عناصر المصفوفة array وانشاء مصفوفة جديدة تضم عناصر المصفوفة array الأكبر من 2، ثم تطبع الناتج:

fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4,5,6)
println(array.filterNot {it < 3}) // [3, 4, 5, 6]
}

استخدام الدالة `()filterNot` مع القواميس: الحالة الأولى

تعرف الشيفرة الآتية قاموسًا باسم map مكونًا من ثلاثة أزواج باستخدام الدالة ()mapOf، ثم تستخدم الدالة ()filterNot لتصفية عناصر القاموس map وانشاء قاموس جديد يضم أزواج القاموس map التي تكون قيمتها (value) أكبر من 1، ثم تطبع الناتج:

fun main(args: Array<String>) {
val map = mapOf("key1" to 1, "key2" to 2, "key3" to 3)
val filteredMap = map.filterNot { it.value < 2 }

println(filteredMap) // {key2=2, key3=3}
}

استخدام الدالة `()filterNot` مع القواميس: الحالة الثانية

تعرف الشيفرة الآتية قاموسًا باسم map مكونًا من ثلاثة أزواج باستخدام الدالة ()mapOf، ثم تستخدم الدالة ()filterNot لتصفية عناصر القاموس map وانشاء قاموس جديد يضم أزواج القاموس map التي تكون قيمتها (value) مساوية للقيمة 0، ولما كانت كل الأزواج لا تحقق هذا الشرط المنطقي فستعيد الدالة ()filterNot قاموسًا يضم كل الأزواج، ثم تطبع الناتج:

fun main(args: Array<String>) {
val map = mapOf("key1" to 1, "key2" to 2, "key3" to 3)
val filteredMap = map.filterNot { it.value == 0 }

println(filteredMap) // {key1=1, key2=2, key3=3}
}

انظر أيضًا

filterIndexed()‎: تعيد لائحة تحتوي عناصر المصفوفة أو المجموعة التي تحقق الشرط المنطقي predicate()‎ المُمرّر إلى الدالة والتي تأخذ قيمة وفهرس عناصر المصفوفة أو المجموعة كوسيطين.
filter()‎: تعيد لائحة تحتوي عناصر المصفوفة أو المجموعة التي تحقق الشرط المنطقي predicate()‎ المُمرّر إلى الدالة. وفي حال استدعائها عبرقاموس فستعيد قاموسًا جديدًا مكونًا من كل الأزوج التي تحقق الشرط المنطقي predicate()‎ الممرر إلى الدالة.
filterIsInstance()‎: تعيد لائحة تحتوي عناصر المصفوفة أو المجموعة التي استُدعيت عبرها والتي هي نسخة (instance) من نوع (type) أوصنفٍ معيّن.
filterIndexedTo()‎: تضيف إلى المعامل destination الممرّر إليها عناصرّ المجموعة المتغيرة (MutableCollection) التي استُدعيت عبرها والتي تحقق الشرط المنطقي predicate()‎ المُمرّر إلى الدالة.

مصادر

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