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

تعيد الدالةsumByDouble()‎ مجموع العناصر المُعادة من الدالة selector مطبقةً على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.

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

يمكن استدعاء الدالةsumByDouble()‎ عبر المصفوفات:

inline fun <T> Array<out T>.sumByDouble(
    selector: (T) -> Double
): Double 
inline fun ByteArray.sumByDouble(
    selector: (Byte) -> Double
): Double 
inline fun ShortArray.sumByDouble(
    selector: (Short) -> Double
): Double 
inline fun IntArray.sumByDouble(
    selector: (Int) -> Double
): Double 
inline fun LongArray.sumByDouble(
    selector: (Long) -> Double
): Double 
inline fun FloatArray.sumByDouble(
    selector: (Float) -> Double
): Double 
inline fun DoubleArray.sumByDouble(
    selector: (Double) -> Double
): Double 
inline fun BooleanArray.sumByDouble(
    selector: (Boolean) -> Double
): Double 
inline fun CharArray.sumByDouble(
    selector: (Char) -> Double
): Double

يمكن استدعاء الدالةsumByDouble()‎ عبر المجموعات :

inline fun <T> Iterable<T>.sumByDouble(
    selector: (T) -> Double
): Double

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

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

مجموع العناصر المُعادة من الدالة selector مطبقةً على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.

أمثلة

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

تعرف الشيفرة الآتية  مصفوفة باسم array مكونة من ستة أعداد باستخدام الدالة ()arrayOf‎، ثم تستخدم الدالة()sumByDouble  على arrayمع تمرير دالة كوسيط، ثم تطبع الناتج:

fun main(args: Array<String>) {
val array = arrayOf(3, 5, 7, 2 , 6, 9)
    
println(array.sumByDouble {it + 0.9} )// 37.4
}

أنظر أيضًا

• sum()‎ : تعيد  مجموع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.
• sumBy()‎ : تعيد مجموع العناصر المُعادة من الدالة selector مطبقةً على عناصر المصفوفة أو المجموعة التي استُدعيت عبرها. 
• subtract()‎ : تعيد مجموعةً (Set) تضم عناصر المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها والتي لا توجد في المجموعة المُمرّرة. 

مصادر

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