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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 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|المجموعة التكرارية]] التي استُدعيت عبرها.
 
  
 +
== المعاملات ==
 +
 +
=== <code>n</code> ===
 +
[[Kotlin/Int|عدد صحيح]] يمثل عدد العناصر الأولى المراد جلبها من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]]، فستعاد كل العناصر الموجودة في [[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 Function]]
 +
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 11:34، 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

عدد صحيح يمثل عدد العناصر الأولى المراد جلبها من المصفوفة أو المجموعة التكرارية المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول المصفوفة أو المجموعة التكرارية، فستعاد كل العناصر الموجودة في المصفوفة أو المجموعة التكرارية آنذاك.

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

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

أمثلة

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

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

انظر أيضًا

مصادر