الدالة requireNoNulls()‎ في لغة Kotlin

تُعيد الدالةrequireNoNulls()‎ مصفوفة أو مجموعة أو لائحة تضم جميع العناصر غير المعدومة (non-null) في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها. في حال كان هناك عنصر معدوم (null) فستطلق الدالةُrequireNoNulls()‎ الاستثناء IllegalArgumentException.

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

fun <T : Any> Array<T?>.requireNoNulls(): Array<T> 
fun <T : Any> Iterable<T?>.requireNoNulls(): Iterable<T> 
fun <T : Any> List<T?>.requireNoNulls(): List<T>

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

مصفوفة أو مجموعة أو لائحة تضم جميع العناصر غير المعدومة (non-null) في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها.

أمثلة

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

تعرف الشيفرة الآتية لائحة باسم list مكونة من ستة أعداد باستخدام الدالة ()List<Int?>‎، ثم تستخدم الدالة ()requireNoNulls على list، ثم تطبع الناتج:

fun main(args: Array<String>) {
var list = List<Int?>(6, { it } ) 
    
print(list.requireNoNulls()) // [0, 1, 2, 3, 4, 5]
}

استخدام الدالة ()requireNoNulls مع المصفوفات: الحالة الثانية

تعرف الشيفرة الآتية لائحة باسم list مكونة من ستة أعداد باستخدام الدالة ()List<Int?>‎، ثم تستخدم الدالة ()requireNoNulls على list، ولما كانتlist تضم عنصرًا يساوي null فستطلق استثناءً، ثم تطبع الناتج:

fun main(args: Array<String>) {
var list = List<Int?>(6, { if (it < 5) it else null } ) // [0, 1, 2, 3, 4, null]
    
print(list.requireNoNulls()) // إطلاق استثناء
}

انظر أيضًا

• reduce()‎: تُراكِم القيم بدءًا من العنصر الأول وتطبّق العملية operation من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي وفهرسه.

مصادر

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