الدالة sumBy() في Kotlin
تجمع الدالة sumBy() جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها.
الفرق بين الدالة sumBy() والدالة sumByDouble() هو في نوع القيمة التي تستطيع الدالة الممرَّر إلى كلٍّ منهما إعادتها، إذ تعيد الدالة المُمرَّرة إلى sumBy() عددًّا صحيحًا (integer) بينما يمكن أن تعيد الدالة الممرَّرة إلى sumByDouble() عددًا عشريًّا مضاعفًا (double).
البنية العامة
يمكن استدعاء الدالة sumBy() مع المصفوفات والمجموعات:
inline fun <T> Array<out T>.sumBy(selector: (T) -> Int): Int
inline fun ByteArray.sumBy(selector: (Byte) -> Int): Int
inline fun ShortArray.sumBy(selector: (Short) -> Int): Int
inline fun IntArray.sumBy(selector: (Int) -> Int): Int
inline fun LongArray.sumBy(selector: (Long) -> Int): Int
inline fun FloatArray.sumBy(selector: (Float) -> Int): Int
inline fun DoubleArray.sumBy(selector: (Double) -> Int): Int
inline fun BooleanArray.sumBy(
selector: (Boolean) -> Int
): Int
inline fun CharArray.sumBy(selector: (Char) -> Int): Int
inline fun <T> Iterable<T>.sumBy(selector: (T) -> Int): Int
يُلاحَظ وجود الكلمة المفتاحية inline التي تدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)).
المعاملات
selector
الدالة التي يراد تطبيقها على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة وتجميع الناتج الذي تعيده.
القيمة المعادة
تعاد القيمة الناتجة عن جمع نواتج تطبيق الدالة selector على كل عنصر من عناصر المصفوفة أو المجموعة المعطاة.
أمثلة
استعمال الدالة ()sumBy لجمع مربعات عناصر مصفوفة:
fun main(args: Array<String>) {
val array = arrayOf(3, 5, 7, 2, 6, 9)
println(array.sumBy { it * it }) // 204
}
انظر أيضًا
- الدالة
sum(): تجمع جميع قيم عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد الناتج. - الدالة
sumByDouble(): تجمع جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها. - الدالة
average(): تحسب متوسط (average) عناصر المصفوفة أو المجموعة (Collection) المعطاة لها. - الدالة
subtract(): تستثني العناصر المشتركة بين كائنين.