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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (استبدال النص - 'Kotlin Functions' ب'Kotlin Function')
ط
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>filterNotTo()‎</code> في Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>filterNotTo()‎</code> في Kotlin}}</noinclude>
تشبه الدالة <code>filterNotTo()‎</code> الدالة <code>[[Kotlin/collections/filterNot|filterNot()‎]]</code> في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. الجدير بالذكر أنّه ينبغي أن يكون ذلك المعامل المعطى مجموعةً قابلةً للتغيير (MutableCollection) إن استدعيت الدالة مع مصفوفة أو مجموعة، أو خريطةً قابلة للتغيير (MutableMap) إن استدعيت الدالة مع خريطة.
+
تشبه الدالة <code>filterNotTo()‎</code> الدالة <code>[[Kotlin/collections/filterNot|filterNot()‎]]</code> في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. الجدير بالذكر أنّه ينبغي أن يكون ذلك المعامل المعطى مجموعةً [[Kotlin/collections/MutableCollection|قابلةً للتغيير]] (MutableCollection) إن استدعيت الدالة مع مصفوفة أو مجموعة، أو خريطةً [[Kotlin/collections/MutableMap|قابلة للتغيير]] (MutableMap) إن استدعيت الدالة مع خريطة.
 
==البنية العامة==
 
==البنية العامة==
 
يمكن استدعاء الدالة <code>filterNotTo()‎</code> مع [[Kotlin/Array|المصفوفات]] أو [[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
 
يمكن استدعاء الدالة <code>filterNotTo()‎</code> مع [[Kotlin/Array|المصفوفات]] أو [[Kotlin/collections|المجموعات]]:<syntaxhighlight lang="kotlin">
سطر 49: سطر 49:
 
): M
 
): M
 
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (لمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]).
 
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (لمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]).
 +
 +
== المعاملات ==
 +
 +
===<code>destination</code>===
 +
كائن موجود مسبقًا يمثل الوجهة المراد إضافة الناتج فيها.
 +
===<code>predicate</code>===
 +
دالةٌ تمثل الشرط المراد تطبيقه على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة المعطاة. يمرر إلى هذه الدالة قيمة العنصر وتعيد قيمة منطقية.
 
==القيم المعادة==
 
==القيم المعادة==
 
يُعاد المعامل <code>destination</code> المعطى بعد إضافة عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي لم تحقق الشرط المنطقي <code>predicate()‎</code> المُمرّر إليها، أو أزواج الخريطة -عند استدعائها مع الخرائط- التي لم تحقق ذلك الشرط المنطقي.
 
يُعاد المعامل <code>destination</code> المعطى بعد إضافة عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي لم تحقق الشرط المنطقي <code>predicate()‎</code> المُمرّر إليها، أو أزواج الخريطة -عند استدعائها مع الخرائط- التي لم تحقق ذلك الشرط المنطقي.
سطر 74: سطر 81:
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Function]]
 
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 08:04، 8 سبتمبر 2018

تشبه الدالة filterNotTo()‎ الدالة filterNot()‎ في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. الجدير بالذكر أنّه ينبغي أن يكون ذلك المعامل المعطى مجموعةً قابلةً للتغيير (MutableCollection) إن استدعيت الدالة مع مصفوفة أو مجموعة، أو خريطةً قابلة للتغيير (MutableMap) إن استدعيت الدالة مع خريطة.

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

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

inline fun <T, C : MutableCollection<in T>> Array<out T>.filterNotTo(
    destination: C, 
    predicate: (T) -> Boolean
): C 
inline fun <C : MutableCollection<in Byte>> ByteArray.filterNotTo(
    destination: C, 
    predicate: (Byte) -> Boolean
): C 
inline fun <C : MutableCollection<in Short>> ShortArray.filterNotTo(
    destination: C, 
    predicate: (Short) -> Boolean
): C 
inline fun <C : MutableCollection<in Int>> IntArray.filterNotTo(
    destination: C, 
    predicate: (Int) -> Boolean
): C 
inline fun <C : MutableCollection<in Long>> LongArray.filterNotTo(
    destination: C, 
    predicate: (Long) -> Boolean
): C 
inline fun <C : MutableCollection<in Float>> FloatArray.filterNotTo(
    destination: C, 
    predicate: (Float) -> Boolean
): C 
inline fun <C : MutableCollection<in Double>> DoubleArray.filterNotTo(
    destination: C, 
    predicate: (Double) -> Boolean
): C 
inline fun <C : MutableCollection<in Boolean>> BooleanArray.filterNotTo(
    destination: C, 
    predicate: (Boolean) -> Boolean
): C 
inline fun <C : MutableCollection<in Char>> CharArray.filterNotTo(
    destination: C, 
    predicate: (Char) -> Boolean
): C 
inline fun <T, C : MutableCollection<in T>> Iterable<T>.filterNotTo(
    destination: C, 
    predicate: (T) -> Boolean
): C

ويمكن استدعاؤها مع الخرائط (maps) أيضًا:

inline fun <K, V, M : MutableMap<in K, in V>> Map<out K, V>.filterNotTo(
    destination: M, 
    predicate: (Entry<K, V>) -> Boolean
): M

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

المعاملات

destination

كائن موجود مسبقًا يمثل الوجهة المراد إضافة الناتج فيها.

predicate

دالةٌ تمثل الشرط المراد تطبيقه على كل عنصر من عناصر المصفوفة أو المجموعة أو الخريطة المعطاة. يمرر إلى هذه الدالة قيمة العنصر وتعيد قيمة منطقية.

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

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

أمثلة

تعرف الشيفرة الآتية قائمتين متغيرتين (mutableList) باسم list1 و list2 باستخدام الدالة ()mutableListOf، ثمَّ تستخدم الدالة ()filterNotTo لاستبعاد عناصر القائمة الأولى الأصغر من القيمة 3 وإضافة العناصر المتبقيَّة إلى القائمة الثانية:

fun main(args: Array<String>) {
    val list = mutableListOf(1, 2, 3, 2, 5, 1)
    val list2 = mutableListOf(0)
    val predicate: (Int) -> Boolean = { it < 3 }

    list.filterNotTo(list2, predicate)

    println(list2) // [0, 3, 5]
}

انظر أيضًا

  • الدالة filterNot()‎: تعيد قائمةً تحوي عناصر المصفوفة أو المجموعة التي لا تحقق شرطًا منطقيًّا محدَّدًا. إن استدعيت مع خريطة (map)، فستعيد خريطة جديدة تحوي الأزواج التي لم تحقق ذلك الشرط المنطقي.
  • الدالة filterNotNull()‎: تعيد جميع عناصر المصفوفة أو المجموعة المعطاة باستثناء تلك ذات القيمة null.
  • الدالة filterNotNullTo()‎: تشبه الدالة filterNotNull()‎ في جميع النواحي باستثناء أنَّها تضيف الناتج الذي تعيده إلى المعامل المُمرَّر إليها.
  • الدالة filterTo()‎: تشبه هذه الدالة في جميع النواحي باستثناء أنها تضيف الناتج إلى المعامل الممرر إليها.
  • الدالة filterIndexedTo()‎: تضيف إلى المجموعة المتغيرة destination المُمرَّر إليها عناصر المصفوفة أو المجموعة المعطاة التي أعيدت القيمة true مع كل عنصر منها عند تطبيق الدالة predicate()‎ المُمرّر عليها. يمرَّر فهرس كل عنصر وقيمته إلى الدالة predicate()‎ ثم تعيد بدورها قيمة منطقيَّة.
  • الدالة filterIsInstanceTo()‎: تضيف عناصر المصفوفة أو المجموعة المعطاة التي هي نسخةٌ (instance) من نوع أو صنفٍ معيّن إلى المجموعة المتغيرة destinationالمُمرّرة إليها.

مصادر