الفرق بين المراجعتين لصفحة: «Kotlin/collections/take»
< Kotlin | collections
أنشأ الصفحة ب'<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>take()</code> [[Kotlin/List|لائحة]] تضم <code>n</code> من أولى العناصر الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها. | ||
==البنية العامة== | ==البنية العامة== | ||
<nowiki/><nowiki/><syntaxhighlight lang="kotlin"> | |||
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> | |||
): Double | |||
): | |||
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
== القيمة المُعادة == | == القيمة المُعادة == | ||
[[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>مع تمرير | تعرف الشيفرة الآتية <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. | 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|المجموعة]] التي استُدعيت عبرها. | ||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/ | *[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]
}