عرض مصدر Kotlin/kotlin.text/sumBy

<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.sumBy()‎</code> في Kotlin}}</noinclude>
تجمع الدالة <code>sumBy()‎</code> جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.  

الفرق بين الدالة <code>sumBy()‎</code> والدالة <code>[[Kotlin/kotlin.text/sumByDouble|sumByDouble()‎]]</code> هو في نوع القيمة التي تستطيع الدالة الممرَّر إلى كلٍّ منهما إعادتها، إذ تعيد الدالة المُمرَّرة إلى <code>sumBy()‎</code> عددًّا صحيحًا (integer) بينما يمكن أن تعيد الدالة الممرَّرة إلى <nowiki/>[[Kotlin/kotlin.text/sumByDouble|<code></code>]]<code>[[Kotlin/collections/sumByDouble|sumByDouble()‎]]</code> عددًا عشريًّا مضاعفًا (double).   
==البنية العامة==
<syntaxhighlight lang="kotlin">
inline fun CharSequence.sumBy(selector: (Char) -> Int): Int 

</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> التي تدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة <nowiki/>[[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
==القيم المعادة==
يعاد عدد صحيح يمثل القيمة الناتجة عن جمع نواتج تطبيق الدالة <code>selector</code> على كل محرف من محارف [[Kotlin/CharSequence|السلسلة]] المعطاة. 
==أمثلة==
مثال على استعمال الدالة <code>()sumBy</code><nowiki/>:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val str = "wiki.hsoub.com"

    println(str.sumBy { it.toInt() }) // 1392
}
</syntaxhighlight>
==انظر أيضًا==
* الدالة <code>[[Kotlin/kotlin.text/sumByDouble|sumByDouble()‎]]</code>: تجمع جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
* الدالة <code>[[Kotlin/kotlin.text/fold|fold()]]‎</code>: تجمِّع تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.
* الدالة <code>[[Kotlin/kotlin.text/groupBy|groupBy()]]</code>‎: تجمِّع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها في مجموعات، إذ تطبق دالة محدَّدة على كل عنصر ثمَّ تعاد خريطة تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من المحارف المقابلة.

==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/sum-by.html صفحة الدالة CharSequence.sumBy()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]