الدالة filterIsInstanceTo() في لغة Kotlin
تضيف الدالةfilterIsInstanceTo() عناصر المصفوفة أو المجموعة التي استُدعيت عبرها و التي هي نسخة (instance) من نوع (type) أو صنفٍ معيّن إلى المجموعة المتغيرة destination المُمرّرة إليها.
البنية العامة
inline fun <reified R, C : MutableCollection<in R>> Array<*>.filterIsInstanceTo(
destination: C
): C
inline fun <reified R, C : MutableCollection<in R>> Iterable<*>.filterIsInstanceTo(
destination: C
): C
يمكن تمرير معامل klass إلى الدالة filterIsInstanceTo():
fun <C : MutableCollection<in R>, R> Array<*>.filterIsInstanceTo(
destination: C,
klass: Class<R>
): C
fun <C : MutableCollection<in R>, R> Iterable<*>.filterIsInstanceTo(
destination: C,
klass: Class<R>
):
بيئة التشغيل المطلوبة: JVM
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
يلاحظ أيضًا استخدام الكلمة المفتاحية reified للتمكّن من الوصول إلى نوعٍ مُمرَّر كمتحولٍ وسيطٍ (parameter)، راجع توثيق reified.
القيم المٌعادة
لائحة تحتوي عناصر المصفوفة أو المجموعة التي استُدعيت عبرها والتي هي نسخة (instance) من نوع (type) أو صنفٍ معيّن.
أمثلة
استخدام الدالة ()filterIsInstanceTo مع المصفوفات
تعرف الشيفرة الآتية مصفوفة باسم arrayمكونة من أعداد وسلاسل نصية باستخدام الدالة ()arrayOf، ثم تعرف لائحة متغيرة (mutableList) تضم عددًا واحدًا (0)باسم list باستخدام الدالة ()mutableListOf، ثم تستخدم الدالة ()filterIsInstanceTo لتصفية عناصر المصفوفة array وانشاء لائحة جديدة تضم الأعداد فقط، ثم تطبع اللائحة:
fun main(args: Array<String>) {
val array = arrayOf("hsoub", 5,"mostaql","kotlin",3)
val list = mutableListOf(0)
array.filterIsInstanceTo(list)
println(list)// [0, 5, 3]
}
انظر أيضًا
filter(): تعيد لائحة تحتوي عناصر المصفوفة أو المجموعة التي تحقق الشرط المنطقيpredicate()المُمرّر إلى الدالة. وفي حال استدعائها عبرقاموس فستعيد قاموسًا جديدًا مكونًا من كل الأزوج التي تحقق الشرط المنطقيpredicate()الممرر إلى الدالة.
filterIndexed(): تعيد لائحة تحتوي عناصر المصفوفة أو المجموعة التي تحقق الشرط المنطقيpredicate()المُمرّر إلى الدالة والتي تأخذ قيمة وفهرس عناصر المصفوفة أو المجموعة كوسيطين.filterIsInstance(): تعيد لائحة تحتوي عناصر المصفوفة أو المجموعة التي استُدعيت عبرها والتي هي نسخة (instance) من نوع (type) أوصنفٍ معيّن.