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

المراجعة الحالية بتاريخ 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]
}

انظر أيضًا

الدالة last()‎: تجلب آخر عنصر من عناصر المصفوفة أو المجموعة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر عنصر يحق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
الدالة take()‎: تجلب أول n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة.
الدالة takeWhile()‎: تجلب أول عناصر محققة لشرطٍ محدَّدٍ من المصفوفة أو القائمة التي استُدعيت معها.
الدالة takeLastWhile()‎: تجلب آخر عناصر محققة لشرطٍ محدَّدٍ من المصفوفة أو القائمة التي استُدعيت معها.
الدالة lastIndexOf()‎: تجلب فهرس آخر ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها.
الدالة drop()‎: تعيد قائمة تحوي جميع عناصر المصفوفة أو المجموعة التي استُدعيت معها باستثناء آخر n عنصر.

مصادر

صفحة الدالة takeLast()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 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|المجموعة التكرارية]] التي استُدعيت معها وتضعها في قائمة.
 ==البنية العامة==
-<nowiki/><nowiki/><syntaxhighlight lang="kotlin">
+<syntaxhighlight lang="kotlin">
 fun <T> Array<out T>.takeLast(n: Int): List<T>
 fun ByteArray.takeLast(n: Int): List<Byte>
@@ سطر 16: / سطر 15: @@
 </syntaxhighlight>
-== القيمة المُعادة ==
-[[Kotlin/List|لائحة]] تضم آخر <code>n</code> من العناصر الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها.
+== المعاملات ==
+=== <code>n</code> ===
+عدد صحيح يمثل عدد العناصر الأخيرة المراد جلبها من <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية، فستعاد كل العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية آنذاك.
+==القيمة المعادة==
+تعاد [[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>) {
-val array = arrayOf(3, 5, 7, 2 , 6, 9)
+    val chars = ('a'..'z').toList()
+     println(chars.takeLast(2)) // [y, z]
-println(array.takeLast(3) ) // [2, 6, 9]
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-* <code>[[Kotlin/collections/take|take()]]</code>‎ : تعيد [[Kotlin/List|لائحة]] تضم  <code>n</code> من أولى العناصر الموجودة في [[Kotlin/Array|المصفوفة]] أو [[Kotlin/Iterable|المجموعة التكرارية]] التي استُدعيت عبرها.
+* الدالة <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-last.html الدالة  takeLast()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/take-last.html صفحة الدالة takeLast()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Collection]]