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

مراجعة 14:39، 8 أغسطس 2018

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

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

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

@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

ومع المجموعات أيضًا :

@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

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

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

أمثلة

استعمال الدالة ()sum لجمع قيم عناصر مصفوفة:

fun main(args: Array<String>) {
    val array = arrayOf(3, 5, 7, 2, 6, 9)

    println(array.sum()) // 32
}

انظر أيضًا

الدالة sumBy()‎: تجمع جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها.
الدالة average()‎: تحسب متوسط (average) عناصر المصفوفة أو المجموعة (Collection) المعطاة لها.
الدالة subtract()‎: تستثني العناصر المشتركة بين كائنين.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>sum()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>sum()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة<code>sum()‎</code> مجموع  عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
+تجمع الدالة <code>sum()‎</code> جميع قيم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها ثمَّ تعيد الناتج.
 ==البنية العامة==
-يمكن استدعاء الدالة<code>sum()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
+يمكن استدعاء الدالة <code>sum()‎</code> مع [[Kotlin/Array|المصفوفات]]:<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
 @JvmName("sumOfByte") fun Array<out Byte>.sum(): Int
 @JvmName("sumOfShort") fun Array<out Short>.sum(): Int
@@ سطر 17: / سطر 17: @@
 fun DoubleArray.sum(): Double
-</syntaxhighlight>يمكن استدعاء الدالة<code>sum()‎</code> عبر  [[Kotlin/collections|المجموعات]] :<syntaxhighlight lang="kotlin">
+</syntaxhighlight>ومع [[Kotlin/collections|المجموعات]] أيضًا :<syntaxhighlight lang="kotlin">
 @JvmName("sumOfByte") fun Iterable<Byte>.sum(): Int
 @JvmName("sumOfShort") fun Iterable<Short>.sum(): Int
@@ سطر 25: / سطر 25: @@
 @JvmName("sumOfDouble") fun Iterable<Double>.sum(): Double
 </syntaxhighlight>
-== القيمة المُعادة ==
+== القيمة المعادة ==
-مجموع  عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
+يعاد ناتج جمع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة.
 ==أمثلة==
-===استخدام الدالة <code>()sum</code> مع المصفوفات===
+<nowiki/><nowiki/><nowiki/>استعمال الدالة <code>()sum</code> لجمع قيم عناصر مصفوفة:<syntaxhighlight lang="kotlin">
-تعرف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] <nowiki/>باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf‎</code>، <nowiki/>ثم تستخدم الدالة<code>()sum</code>  على <code>array</code> لحساب مجموع عناصرها، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val array = arrayOf(3, 5, 7, 2 , 6, 9)
+    val array = arrayOf(3, 5, 7, 2, 6, 9)
-println(array.sum())// 32
+     println(array.sum()) // 32
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-* <code>[[Kotlin/collections/subtract|subtract()]]</code>‎ : تعيد [[Kotlin/Set|مجموعةً]] (<code>Set</code>)  تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها والتي لا توجد في  [[Kotlin/collections|المجموعة]] المُمرّرة.
+* الدالة <code>[[Kotlin/collections/sumBy|sumBy()]]</code>‎: تجمع جميع نواتج تطبيق دالة معيَّنة على كل عنصر من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
+* الدالة <code>[[Kotlin/collections/average|average()‎]]</code>: تحسب متوسط (average) عناصر المصفوفة أو المجموعة ([[Kotlin/collections|Collection]]) المعطاة لها.
+* الدالة [[Kotlin/collections/subtract|<code>subtract()</code>]]‎: تستثني العناصر المشتركة بين كائنين.
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sum.html الدالة  sum()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sum.html صفحة الدالة sum()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]