الفرق بين المراجعتين ل"Kotlin/collections/filterNotNull"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>filterNotNull()</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>filterNotNull()</code> Kotlin/Ar...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>filterNotNull()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>filterNotNull()</code> في لغة Kotlin}}</noinclude> | ||
| − | تعيد الدالة<code>filterNotNull()</code> [[Kotlin/Array|لائحة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي | + | تعيد الدالة<code>filterNotNull()</code> [[Kotlin/Array|لائحة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] غير المعدومة، أي التي تخالف قيمتها <code>null</code><nowiki/><nowiki/>. |
==البنية العامة== | ==البنية العامة== | ||
| − | + | <syntaxhighlight lang="kotlin"> | |
| − | + | fun <T : Any> Array<out T?>.filterNotNull(): List<T> | |
| − | + | fun <T : Any> Iterable<T?>.filterNotNull(): List<T> | |
| − | ): List<T> | + | </syntaxhighlight> |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | ): List<T | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | </syntaxhighlight> | ||
| − | |||
== القيم المٌعادة == | == القيم المٌعادة == | ||
| − | [[Kotlin/Array|لائحة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي | + | [[Kotlin/Array|لائحة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] غير المعدومة، أي التي تخالف قيمتها <code>null</code>. |
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()filterNotNull</code> مع المصفوفات=== | ===استخدام الدالة <code>()filterNotNull</code> مع المصفوفات=== | ||
| − | تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة | + | تعرف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code>مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة <code>()filterNotNull</code> لتصفية عناصر [[Kotlin/Array|المصفوفة]] <code>array</code> وانشاء [[Kotlin/collections/List|لائحة]] جديدة تضم عناصر [[Kotlin/Array|المصفوفة]] <code>array</code> التي تخالف <code>null</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> |
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | val array = arrayOf(1,2,3, | + | val array = arrayOf(1,2,3,null,5,6) |
| − | println(array. | + | println(array.filterNotNull() )// [1, 2, 3, 5, 6] |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===انظر أيضًا=== | ===انظر أيضًا=== | ||
| + | *<code>[[Kotlin/collections/filterNot|filterNot()]]</code>: تعيد [[Kotlin/Array|لائحة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي لا تحقق الشرط المنطقي <code>predicate()</code> المُمرّر إلى الدالة. وفي حال استدعائها عبر [[Kotlin/collections/Map|قاموس]] فستعيد قاموسًا جديدًا مكونًا من كل الأزوج التي لا تحقق الشرط المنطقي <code>predicate()</code> الممرر إلى الدالة. | ||
*<code>[[Kotlin/collections/filterIndexed|filterIndexed()]]</code>: تعيد [[Kotlin/Array|لائحة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي تحقق الشرط المنطقي <code>predicate()</code> المُمرّر إلى الدالة والتي تأخذ قيمة وفهرس عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] كوسيطين. | *<code>[[Kotlin/collections/filterIndexed|filterIndexed()]]</code>: تعيد [[Kotlin/Array|لائحة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي تحقق الشرط المنطقي <code>predicate()</code> المُمرّر إلى الدالة والتي تأخذ قيمة وفهرس عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] كوسيطين. | ||
*<code>[[Kotlin/collections/filter|filter()]]</code>: تعيد <nowiki/>[[Kotlin/Array|لائحة]] تحتوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي تحقق الشرط المنطقي <code>predicate()</code> المُمرّر إلى الدالة. وفي حال استدعائها عبرقاموس فستعيد قاموسًا جديدًا مكونًا من كل الأزوج التي تحقق الشرط المنطقي <code>predicate()</code> الممرر إلى الدالة. | *<code>[[Kotlin/collections/filter|filter()]]</code>: تعيد <nowiki/>[[Kotlin/Array|لائحة]] تحتوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي تحقق الشرط المنطقي <code>predicate()</code> المُمرّر إلى الدالة. وفي حال استدعائها عبرقاموس فستعيد قاموسًا جديدًا مكونًا من كل الأزوج التي تحقق الشرط المنطقي <code>predicate()</code> الممرر إلى الدالة. | ||
| سطر 77: | سطر 26: | ||
==مصادر== | ==مصادر== | ||
<span> </span> | <span> </span> | ||
| − | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/filter-not.html الدالة filterNotNull() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/filter-not-null.html الدالة filterNotNull() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 15:32، 15 مايو 2018
تعيد الدالةfilterNotNull() لائحة تحتوي عناصر المصفوفة أو المجموعة غير المعدومة، أي التي تخالف قيمتها null.
البنية العامة
fun <T : Any> Array<out T?>.filterNotNull(): List<T>
fun <T : Any> Iterable<T?>.filterNotNull(): List<T>
القيم المٌعادة
لائحة تحتوي عناصر المصفوفة أو المجموعة غير المعدومة، أي التي تخالف قيمتها null.
أمثلة
استخدام الدالة ()filterNotNull مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من ستة عناصر باستخدام الدالة ()arrayOf، ثم تستخدم الدالة ()filterNotNull لتصفية عناصر المصفوفة array وانشاء لائحة جديدة تضم عناصر المصفوفة array التي تخالف null، ثم تطبع الناتج:
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,null,5,6)
println(array.filterNotNull() )// [1, 2, 3, 5, 6]
}
انظر أيضًا
filterNot(): تعيد لائحة تحتوي عناصر المصفوفة أو المجموعة التي لا تحقق الشرط المنطقيpredicate()المُمرّر إلى الدالة. وفي حال استدعائها عبر قاموس فستعيد قاموسًا جديدًا مكونًا من كل الأزوج التي لا تحقق الشرط المنطقيpredicate()الممرر إلى الدالة.filterIndexed(): تعيد لائحة تحتوي عناصر المصفوفة أو المجموعة التي تحقق الشرط المنطقيpredicate()المُمرّر إلى الدالة والتي تأخذ قيمة وفهرس عناصر المصفوفة أو المجموعة كوسيطين.filter(): تعيد لائحة تحتوي عناصر المصفوفة أو المجموعة التي تحقق الشرط المنطقيpredicate()المُمرّر إلى الدالة. وفي حال استدعائها عبرقاموس فستعيد قاموسًا جديدًا مكونًا من كل الأزوج التي تحقق الشرط المنطقيpredicate()الممرر إلى الدالة.filterIsInstance(): تعيد لائحة تحتوي عناصر المصفوفة أو المجموعة التي استُدعيت عبرها والتي هي نسخة (instance) من نوع (type) أوصنفٍ معيّن.filterIndexedTo(): تضيف إلى المعاملdestinationالممرّر إليها عناصرّ المجموعة المتغيرة (MutableCollection) التي استُدعيت عبرها والتي تحقق الشرط المنطقيpredicate()المُمرّر إلى الدالة.
مصادر