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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>take()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>take()‎</code> مجموع العناصر ا...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>take()‎</code> في لغة Kotlin}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: الدالة <code>take()‎</code> في لغة Kotlin}}</noinclude>
تعيد الدالة<code>take()‎</code> مجموع  العناصر المُعادة من الدالة <code>selector</code> مطبقةً على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.  
+
تعيد الدالة<code>take()‎</code> [[Kotlin/List|لائحة]] تضم <code>n</code> من أولى العناصر الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها.  
  
 
==البنية العامة==
 
==البنية العامة==
يمكن استدعاء الدالة<code>sumByDouble()‎</code> عبر [[Kotlin/Array|المصفوفات]]:<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
+
<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
inline fun <T> Array<out T>.sumByDouble(
+
fun <T> Array<out T>.take(n: Int): List<T>  
    selector: (T) -> Double
+
fun ByteArray.take(n: Int): List<Byte>  
): Double
+
fun ShortArray.take(n: Int): List<Short>  
inline fun ByteArray.sumByDouble(
+
fun IntArray.take(n: Int): List<Int>  
    selector: (Byte) -> Double
+
fun LongArray.take(n: Int): List<Long>  
): Double
+
fun FloatArray.take(n: Int): List<Float>
inline fun ShortArray.sumByDouble(
+
fun DoubleArray.take(n: Int): List<Double>
    selector: (Short) -> Double
+
fun BooleanArray.take(n: Int): List<Boolean>  
): Double
+
fun CharArray.take(n: Int): List<Char>  
inline fun IntArray.sumByDouble(
+
fun <T> Iterable<T>.take(n: Int): List<T>
    selector: (Int) -> Double
 
): Double
 
inline fun LongArray.sumByDouble(
 
    selector: (Long) -> Double
 
): Double
 
inline fun FloatArray.sumByDouble(
 
    selector: (Float) -> Double
 
): Double
 
inline fun DoubleArray.sumByDouble(
 
    selector: (Double) -> Double
 
): Double  
 
inline fun BooleanArray.sumByDouble(
 
    selector: (Boolean) -> Double
 
): Double
 
inline fun CharArray.sumByDouble(
 
    selector: (Char) -> Double
 
): Double
 
  
</syntaxhighlight>يمكن استدعاء الدالة<code>sumByDouble()‎</code> عبر  [[Kotlin/collections|المجموعات]] :<syntaxhighlight lang="kotlin">
 
inline fun <T> Iterable<T>.sumByDouble(
 
    selector: (T) -> Double
 
): Double
 
 
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 
 
== القيمة المُعادة ==
 
== القيمة المُعادة ==
مجموع  العناصر المُعادة من الدالة <code>selector</code> مطبقةً على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
+
[[Kotlin/List|لائحة]] تضم <code>n</code> من العناصر الأولى الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها.
  
 
==أمثلة==
 
==أمثلة==
 
===استخدام الدالة <code>()take</code> مع المصفوفات===
 
===استخدام الدالة <code>()take</code> مع المصفوفات===
تعرف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] <nowiki/>باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf‎</code>، <nowiki/>ثم تستخدم الدالة<code>()take</code>  على <code>array</code>مع تمرير دالة كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+
تعرف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] <nowiki/>باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf‎</code>، <nowiki/>ثم تستخدم الدالة<code>()take</code>  على <code>array</code> مع تمرير العدد <code>3</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)
 
      
 
      
println(array.sumByDouble {it + 0.9} )// 37.4
+
println(array.take(3) )// [3, 5, 7]
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==أنظر أيضًا==
 
==أنظر أيضًا==
 
* <code>[[Kotlin/collections/sum|sum()]]</code>‎ : تعيد  مجموع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
 
* <code>[[Kotlin/collections/sum|sum()]]</code>‎ : تعيد  مجموع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
* <code>[[Kotlin/collections/sumBy|sumBy()]]</code>‎ : تعيد مجموع  العناصر المُعادة من الدالة <code>selector</code> مطبقةً على عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها. 
 
* <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/sum-by-double.html الدالة  take()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/take.html الدالة  take()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

مراجعة 17:41، 23 يونيو 2018

تعيد الدالةtake()‎ لائحة تضم n من أولى العناصر الموجودة في المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.

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

fun <T> Array<out T>.take(n: Int): List<T> 
fun ByteArray.take(n: Int): List<Byte> 
fun ShortArray.take(n: Int): List<Short> 
fun IntArray.take(n: Int): List<Int> 
fun LongArray.take(n: Int): List<Long> 
fun FloatArray.take(n: Int): List<Float>
fun DoubleArray.take(n: Int): List<Double> 
fun BooleanArray.take(n: Int): List<Boolean> 
fun CharArray.take(n: Int): List<Char> 
fun <T> Iterable<T>.take(n: Int): List<T>

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

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

لائحة تضم n من العناصر الأولى الموجودة في المصفوفة أو المجموعة التكرارية التي استُدعيت عبرها.

أمثلة

استخدام الدالة ()take مع المصفوفات

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

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

أنظر أيضًا

مصادر