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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق.)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>take()‎</code> في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>take()‎</code> في Kotlin}}</noinclude>
تعيد الدالة<code>take()‎</code> [[Kotlin/List|لائحة]] تضم  <code>n</code> من أولى العناصر الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها.  
+
تجلب الدالة <code>take()‎</code> أول <code>n</code> عنصر من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها وتضعها في قائمة.  
 
 
 
==البنية العامة==
 
==البنية العامة==
<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
+
<syntaxhighlight lang="kotlin">
 
fun <T> Array<out T>.take(n: Int): List<T>  
 
fun <T> Array<out T>.take(n: Int): List<T>  
 
fun ByteArray.take(n: Int): List<Byte>  
 
fun ByteArray.take(n: Int): List<Byte>  
سطر 15: سطر 14:
 
fun <T> Iterable<T>.take(n: Int): List<T>  
 
fun <T> Iterable<T>.take(n: Int): List<T>  
  
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+
</syntaxhighlight>
== القيمة المُعادة ==
+
==القيمة المعادة==
[[Kotlin/List|لائحة]] تضم <code>n</code> من العناصر الأولى الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها.
+
تعاد [[Kotlin/List|قائمة]] تحوي أول <code>n</code> من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] المعطاة.
 
 
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة <code>()take</code> مع المصفوفات===
+
استعمال الدالة <code>()take</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 chars = ('a'..'z').toList()
      
+
     println(chars.take(3)) // [a, b, c]
println(array.take(3) )// [3, 5, 7]
 
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
==أنظر أيضًا==
+
==انظر أيضًا==
* <code>[[Kotlin/collections/sum|sum()]]</code>‎ : تعيد  مجموع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
+
* الدالة <code>[[Kotlin/collections/first|first()]]</code>: تجلب أول عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
 
+
*الدالة <code>[[Kotlin/collections/takeLast|takeLast()]]</code>‎: تجلب آخر <code>n</code> عنصر من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها وتضعها في قائمة.
 +
*الدالة <code>[[Kotlin/collections/takeWhile|takeWhile()‎]]</code>: تجلب أول عناصر محققة لشرطٍ محدَّدٍ من [[Kotlin/Array|المصفوفة]] أو  [[Kotlin/List|القائمة]] التي استُدعيت معها.
 +
*الدالة <code>[[Kotlin/collections/takeLastWhile|takeLastWhile()]]</code>‎: تجلب آخر عناصر محققة لشرطٍ محدَّدٍ من [[Kotlin/Array|المصفوفة]] أو  [[Kotlin/List|القائمة]] التي استُدعيت معها.
 +
* الدالة <code>[[Kotlin/collections/indexOf|indexOf()‎]]</code>: تجلب فهرس أول ظهور لعنصر محدَّد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها.
 +
* الدالة <code>[[Kotlin/collections/find|find()]]</code>‎: تبحث على عنصر محدَّد ضمن عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له.
 +
* الدالة <code>[[Kotlin/collections/filter|filter()‎]]</code>: ترشِّح عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها.
 
==مصادر==
 
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/take.html الدالة  take()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/take.html صفحة الدالة take()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Functions]]
 
[[تصنيف:Kotlin Functions]]

مراجعة 15:54، 8 أغسطس 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>

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

تعاد قائمة تحوي أول n من عناصر المصفوفة أو المجموعة التكرارية المعطاة.

أمثلة

استعمال الدالة ()take لجلب أول ثلاثة عناصر من قائمة:

fun main(args: Array<String>) {
    val chars = ('a'..'z').toList()
    println(chars.take(3)) // [a, b, c]
}

انظر أيضًا

مصادر