الفرق بين المراجعتين ل"Kotlin/collections/sum"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>sum()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>sum()‎</code> مجموعة (<c...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>sum()‎</code> في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>sum()‎</code> في لغة Kotlin}}</noinclude>
−
تعيد الدالة<code>sum()‎</code> [[Kotlin/Set|مجموعة]] (<code>Set</code>) تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها والتي لا توجد في  [[Kotlin/collections|المجموعة]] المُمرّرة.  
+
تعيد الدالة<code>sum()‎</code> مجموع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.  
−
 
 
−
[[Kotlin/Set|المجموعة]] (<code>Set</code>) المُعادة تحافظ على ترتيب التكرار الخاص [[Kotlin/collections|بالمجموعة]] (<code>collection</code>) المُمررة. 
 
  
 
==البنية العامة==
 
==البنية العامة==
 
يمكن استدعاء الدالة<code>sum()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
 
يمكن استدعاء الدالة<code>sum()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
−
infix fun <T> Array<out T>.subtract(
+
@JvmName("sumOfByte") fun Array<out Byte>.sum(): Int
−
    other: Iterable<T>
+
@JvmName("sumOfShort") fun Array<out Short>.sum(): Int
−
): Set<T>  
+
@JvmName("sumOfInt") fun Array<out Int>.sum(): Int  
−
infix fun ByteArray.subtract(
+
@JvmName("sumOfLong") fun Array<out Long>.sum(): Long  
−
    other: Iterable<Byte>
+
@JvmName("sumOfFloat") fun Array<out Float>.sum(): Float
−
): Set<Byte>
+
@JvmName("sumOfDouble") fun Array<out Double>.sum(): Double  
−
infix fun ShortArray.subtract(
+
fun ByteArray.sum(): Int
−
    other: Iterable<Short>
+
fun ShortArray.sum(): Int
−
): Set<Short>  
+
fun IntArray.sum(): Int
−
infix fun IntArray.subtract(other: Iterable<Int>): Set<Int>
+
fun LongArray.sum(): Long
−
infix fun LongArray.subtract(
+
fun FloatArray.sum(): Float
−
    other: Iterable<Long>
+
fun DoubleArray.sum(): Double
−
): Set<Long>
 
−
infix fun FloatArray.subtract(
 
−
    other: Iterable<Float>
 
−
): Set<Float>
 
−
infix fun DoubleArray.subtract(
 
−
    other: Iterable<Double>
 
−
): Set<Double>
 
−
infix fun BooleanArray.subtract(
 
−
    other: Iterable<Boolean>
 
−
): Set<Boolean>
 
−
infix fun CharArray.subtract(
 
−
    other: Iterable<Char>
 
−
): Set<Char>
 
−
 
 
−
</syntaxhighlight>يمكن استدعاء الدالة<code>sum()‎</code> عبر [[Kotlin/Iterable|المجموعات التكرارية]] :<syntaxhighlight lang="kotlin">
 
−
infix fun <T> Iterable<T>.subtract(
 
−
    other: Iterable<T>
 
−
): Set<T>
 
−
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
  
 +
</syntaxhighlight>يمكن استدعاء الدالة<code>sum()‎</code> عبر  [[Kotlin/collections|المجموعات]] :<syntaxhighlight lang="kotlin">
 +
@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
 +
</syntaxhighlight>
 
== القيمة المُعادة ==
 
== القيمة المُعادة ==
−
[[Kotlin/Set|مجموعة]] (<code>Set</code>) تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها والتي لا توجد في  [[Kotlin/collections|المجموعة]] المُمرّرة.
+
مجموع عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
  
 
==أمثلة==
 
==أمثلة==
 
===استخدام الدالة <code>()sum</code> مع المصفوفات===
 
===استخدام الدالة <code>()sum</code> مع المصفوفات===
−
تعرف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] <nowiki/>باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf‎</code>، ثم تعرّف  <nowiki/>[[Kotlin/List|لائحة]] باسم <code>list</code> مكونة من ثلاثة أعداد باستخدام الدالة <code>()listOf</code>، ثم تستخدم الدالة<code>()sum</code>  على <code>array</code> بتمرير  <code>list</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>) {
 
fun main(args: Array<String>) {
 
val array = arrayOf(3, 5, 7, 2 , 6, 9)
 
val array = arrayOf(3, 5, 7, 2 , 6, 9)
−
val list = listOf(3, 9, 1)
 
 
      
 
      
−
println(array.subtract(list))// [5, 7, 2, 6]
+
println(array.sum())// 32
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==أنظر أيضًا==
 
==أنظر أيضًا==
−
* <code>[[Kotlin/collections/sort|sort()]]</code>‎ : تقوم بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها.
+
* <code>[[Kotlin/collections/subtract|subtract()]]</code>‎ : تعيد [[Kotlin/Set|مجموعةً]] (<code>Set</code>) تضم عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها والتي لا توجد في  [[Kotlin/collections|المجموعة]] المُمرّرة. 
  
 
==مصادر==
 
==مصادر==
−
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/subtract.html الدالة  sum()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sum.html الدالة  sum()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

مراجعة 13:37، 23 يونيو 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

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

@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 مع المصفوفات

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

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

أنظر أيضًا

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/collections/sum&oldid=11086"