الفرق بين المراجعتين لصفحة: «Kotlin/collections/takeLast»

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>takeLast()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>takeLast()‎</code> Kotlin/List|لائ...'
 
طلا ملخص تعديل
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>takeLast()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>takeLast()‎</code> في Kotlin}}</noinclude>
تعيد الدالة<code>takeLast()‎</code> [[Kotlin/List|لائحة]] تضم <code>n</code> من أولى العناصر الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها.  
تجلب الدالة <code>takeLast()‎</code> آخر <code>n</code> عنصر من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت معها وتضعها في قائمة. 
==البنية العامة==
<syntaxhighlight lang="kotlin">
fun <T> Array<out T>.takeLast(n: Int): List<T>
fun ByteArray.takeLast(n: Int): List<Byte>
fun ShortArray.takeLast(n: Int): List<Short>
fun IntArray.takeLast(n: Int): List<Int>
fun LongArray.takeLast(n: Int): List<Long>
fun FloatArray.takeLast(n: Int): List<Float>
fun DoubleArray.takeLast(n: Int): List<Double>
fun BooleanArray.takeLast(n: Int): List<Boolean>
fun CharArray.takeLast(n: Int): List<Char>
fun <T> List<T>.takeLast(n: Int): List<T>


==البنية العامة==
</syntaxhighlight>
<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>


</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
=== <code>n</code> ===
== القيمة المُعادة ==
عدد صحيح يمثل عدد العناصر الأخيرة المراد جلبها من <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية، فستعاد كل العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية آنذاك.
[[Kotlin/List|لائحة]] تضم <code>n</code> من العناصر الأولى الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها.


==القيمة المعادة==
تعاد [[Kotlin/List|قائمة]] تحوي آخر <code>n</code> من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] المعطاة.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()takeLast</code> مع المصفوفات===
استعمال الدالة <code>()takeLast</code> لجلب آخر عنصرين من قائمة:<syntaxhighlight lang="kotlin">
تعرف الشيفرة الآتية  <nowiki/>[[Kotlin/Array|مصفوفة]] <nowiki/>باسم <code>array</code> مكونة من ستة أعداد باستخدام الدالة <code>()arrayOf‎</code>، <nowiki/>ثم تستخدم الدالة<code>()takeLast</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.takeLast(2)) // [y, z]
println(array.take(3) )// [3, 5, 7]
}
}
</syntaxhighlight>
</syntaxhighlight>
==أنظر أيضًا==
==انظر أيضًا==
* <code>[[Kotlin/collections/sum|sum()]]</code>‎ : تعيد  مجموع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
* الدالة <code>[[Kotlin/collections/last|last()]]</code>‎: تجلب آخر عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
 
*الدالة <code>[[Kotlin/collections/take|take()]]</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/lastIndexOf|lastIndexOf()]]</code>‎: تجلب فهرس آخر ظهور لعنصر محدَّد من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو القائمة التي استُدعيت معها.
* الدالة <code>[[Kotlin/collections/drop|drop()]]</code>‎: تعيد قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء آخر <code>n</code> عنصر.
==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/take.html الدالة  takeLast()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/take-last.html صفحة الدالة takeLast()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

المراجعة الحالية بتاريخ 11:35، 8 سبتمبر 2018

تجلب الدالة takeLast()‎ آخر n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة. 

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

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

المعاملات

n

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

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

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

أمثلة

استعمال الدالة ()takeLast لجلب آخر عنصرين من قائمة:

fun main(args: Array<String>) {
    val chars = ('a'..'z').toList()
    println(chars.takeLast(2)) // [y, z]
}

انظر أيضًا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/collections/takeLast&oldid=17196»