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

تعيد الدالةsumBy()‎ مجموع عناصر المصفوفة أو المجموعة التي استُدعيت عبرها.

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

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

@JvmName("sumOfByte") fun Array<out Byte>.sum(): Int 
@JvmName("sumOfShort") fun Array<out Short>.sum(): Int 
@JvmName("sumOfInt") fun Array<out Int>.sum(): Int 
@JvmName("sumOfLong") fun Array<out Long>.sum(): Long 
@JvmName("sumOfFloat") fun Array<out Float>.sum(): Float
@JvmName("sumOfDouble") fun Array<out Double>.sum(): Double 
fun ByteArray.sum(): Int
fun ShortArray.sum(): Int 
fun IntArray.sum(): Int 
fun LongArray.sum(): Long 
fun FloatArray.sum(): Float 
fun DoubleArray.sum(): Double

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

@JvmName("sumOfByte") fun Iterable<Byte>.sum(): Int
@JvmName("sumOfShort") fun Iterable<Short>.sum(): Int 
@JvmName("sumOfInt") fun Iterable<Int>.sum(): Int 
@JvmName("sumOfLong") fun Iterable<Long>.sum(): Long 
@JvmName("sumOfFloat") fun Iterable<Float>.sum(): Float 
@JvmName("sumOfDouble") fun Iterable<Double>.sum(): Double

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

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

أمثلة

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

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

fun main(args: Array<String>) {
val array = arrayOf(3, 5, 7, 2 , 6, 9)
    
println(array.sum())// 32
}

أنظر أيضًا

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

مصادر

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