الفرق بين المراجعتين لصفحة: «Kotlin/collections/average»

من موسوعة حسوب
لا ملخص تعديل
طلا ملخص تعديل
 
(7 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>average()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>average()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>average()‎</code> متوسط (average) عناصر المصفوفة أو المجموعة (<code>[[Kotlin/collections|Collection]]</code>).  
تحسب الدالة <code>average()‎</code> متوسط (average) عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة لها.  
==البنية العامة==
==البنية العامة==
يمكن استدعاء الدالة <code>average()‎</code>عبر المصفوفات:<syntaxhighlight lang="kotlin">
يمكن استدعاء الدالة <code>average()‎</code> مع المصفوفات:<syntaxhighlight lang="kotlin">
@JvmName("averageOfByte") fun Array<out Byte>.average(): Double  
@JvmName("averageOfByte") fun Array<out Byte>.average(): Double  
@JvmName("averageOfShort") fun Array<out Short>.average(): Double
@JvmName("averageOfShort") fun Array<out Short>.average(): Double
سطر 18: سطر 18:
</syntaxhighlight>
</syntaxhighlight>


يمكن استدعاء الدالة <code>average()‎</code>عبر المجموعات (<code>[[Kotlin/collections|Collection]]</code>):<syntaxhighlight lang="kotlin">
ويمكن استدعاؤها مع المجموعات:<syntaxhighlight lang="kotlin">
@JvmName("averageOfByte") fun Iterable<Byte>.average(): Double  
@JvmName("averageOfByte") fun Iterable<Byte>.average(): Double  
@JvmName("averageOfShort") fun Iterable<Short>.average(): Double  
@JvmName("averageOfShort") fun Iterable<Short>.average(): Double  
سطر 27: سطر 27:
</syntaxhighlight>
</syntaxhighlight>
==القيم المعادة==
==القيم المعادة==
عدد من النوع <code>Double</code> يساوي متوسط عناصر المجموعة أو المصفوفة التي استٌدعي عبرها.
يعاد عددٌ من النوع <code>Double</code> يساوي متوسط عناصر المجموعة أو المصفوفة المعطاة.


==أمثلة==
==أمثلة==
===استخدام الدالة <code>()average</code> مع اللوائح ===
تعرِّف الشيفرة الآتية لائحة باسم <code>list</code> مكونة من أربعة أعداد باستخدام الدالة <code>()listOf</code> وتحسب متوسط تلك الأعداد باستخدام الدالة <code>()average</code> ثم تطبع النتيجة:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية لائحة باسم <code>list</code> مكونة من أربعة أعداد باستخدام الدالة <code>()listOf</code>، ثم تحسب متوسط تلك الأعداد باستخدام الدالة <code>()average</code> ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
     val list = listOf(1,2,3,4)
     val list = listOf(1, 2, 3, 4)
     println(list.average()) // 2.5
     println(list.average()) // 2.5
}
}
</syntaxhighlight>
</syntaxhighlight>
==انظر أيضًا==
==انظر أيضًا==
*صفحة  المجموعة (<code>[[Kotlin/collections|Collection]]</code>).  
* الدالة <code>[[Kotlin/collections/sum|sum()]]</code>‎: تجمع جميع قيم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها ثمَّ تعيد الناتج.


==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/average.html الدالة  average()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/average.html صفحة الدالة average()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 07:26، 8 سبتمبر 2018

تحسب الدالة 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
}

انظر أيضًا

مصادر