الدالة average()‎ في Kotlin

تحسب الدالة average()‎ متوسط (average) عناصر المصفوفة أو المجموعة (Collection) المعطاة لها.

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

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

@JvmName("averageOfByte") fun Array<out Byte>.average(): Double 
@JvmName("averageOfShort") fun Array<out Short>.average(): Double
@JvmName("averageOfInt") fun Array<out Int>.average(): Double 
@JvmName("averageOfLong") fun Array<out Long>.average(): Double 
@JvmName("averageOfFloat") fun Array<out Float>.average(): Double 
@JvmName("averageOfDouble") fun Array<out Double>.average(): Double 
fun ByteArray.average(): Double 
fun ShortArray.average(): Double 
fun IntArray.average(): Double 
fun LongArray.average(): Double 
fun FloatArray.average(): Double
fun DoubleArray.average(): Double

ويمكن استدعاؤها مع المجموعات:

@JvmName("averageOfByte") fun Iterable<Byte>.average(): Double 
@JvmName("averageOfShort") fun Iterable<Short>.average(): Double 
@JvmName("averageOfInt") fun Iterable<Int>.average(): Double 
@JvmName("averageOfLong") fun Iterable<Long>.average(): Double 
@JvmName("averageOfFloat") fun Iterable<Float>.average(): Double
@JvmName("averageOfDouble") fun Iterable<Double>.average(): Double

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

يعاد عددٌ من النوع Double يساوي متوسط عناصر المجموعة أو المصفوفة المعطاة.

أمثلة

تعرِّف الشيفرة الآتية لائحة باسم list مكونة من أربعة أعداد باستخدام الدالة ()listOf وتحسب متوسط تلك الأعداد باستخدام الدالة ()average ثم تطبع النتيجة:

fun main(args: Array<String>) {
    val list = listOf(1, 2, 3, 4)
    println(list.average()) // 2.5
}

انظر أيضًا

• الدالة sum()‎: تجمع جميع قيم عناصر المصفوفة أو المجموعة التي استُدعيت معها ثمَّ تعيد الناتج.

مصادر

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