الفرق بين المراجعتين لصفحة: «Kotlin/collections/slice»
< Kotlin | collections
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين) | |||
| سطر 26: | سطر 26: | ||
fun <T> List<T>.slice(indices: Iterable<Int>): List<T> | fun <T> List<T>.slice(indices: Iterable<Int>): List<T> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | |||
=== <code>indices</code> === | |||
مجال من النوع <code>[[Kotlin/ranges/IntRange|IntRange]]</code> أو كائن من النوع <code>[[Kotlin/collections/Iterable|Iterable]]</code> يحدد الجزء المراد اقتطاعه من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/List|القائمة]] المعطاة. | |||
==القيم المعادة== | ==القيم المعادة== | ||
تُعاد [[Kotlin/List|قائمة]] تحوي جزءًا من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/List|القائمة]] <nowiki/>المعطاة يحدِّده الوسيط <code>indices</code> المعطى. | تُعاد [[Kotlin/List|قائمة]] تحوي جزءًا من [[Kotlin/Array|المصفوفة]] أو [[Kotlin/List|القائمة]] <nowiki/>المعطاة يحدِّده الوسيط <code>indices</code> المعطى. | ||
| سطر 44: | سطر 50: | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/slice.html صفحة الدالة slice() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/slice.html صفحة الدالة slice() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Collection]] | |||
المراجعة الحالية بتاريخ 10:15، 8 سبتمبر 2018
تقطع الدالة slice() جزءًا محدَّدًا من المصفوفة أو القائمة التي استُدعيت معها ثمَّ تعيده في قائمة.
البنية العامة
يمكن تمرير مجال محدَّد إلى الدالة slice() كوسيط:
fun <T> Array<out T>.slice(indices: IntRange): List<T>
fun ByteArray.slice(indices: IntRange): List<Byte>
fun ShortArray.slice(indices: IntRange): List<Short>
fun IntArray.slice(indices: IntRange): List<Int>
fun LongArray.slice(indices: IntRange): List<Long>
fun FloatArray.slice(indices: IntRange): List<Float>
fun DoubleArray.slice(indices: IntRange): List<Double>
fun BooleanArray.slice(indices: IntRange): List<Boolean>
fun CharArray.slice(indices: IntRange): List<Char>
fun <T> List<T>.slice(indices: IntRange): List<T>
أو يمكن تمرير كائن من النوع Iterable إلى الدالة slice() كوسيط:
fun <T> Array<out T>.slice(indices: Iterable<Int>): List<T>
fun ByteArray.slice(indices: Iterable<Int>): List<Byte>
fun ShortArray.slice(indices: Iterable<Int>): List<Short>
fun IntArray.slice(indices: Iterable<Int>): List<Int>
fun LongArray.slice(indices: Iterable<Int>): List<Long>
fun FloatArray.slice(indices: Iterable<Int>): List<Float>
fun DoubleArray.slice(indices: Iterable<Int>): List<Double>
fun BooleanArray.slice(indices: Iterable<Int>): List<Boolean>
fun CharArray.slice(indices: Iterable<Int>): List<Char>
fun <T> List<T>.slice(indices: Iterable<Int>): List<T>
المعاملات
indices
مجال من النوع IntRange أو كائن من النوع Iterable يحدد الجزء المراد اقتطاعه من المصفوفة أو القائمة المعطاة.
القيم المعادة
تُعاد قائمة تحوي جزءًا من المصفوفة أو القائمة المعطاة يحدِّده الوسيط indices المعطى.
أمثلة
استعمال الدالة ()slice لجلب جزء من مصفوفة يقع بين العنصر الثاني والخامس:
fun main(args: Array<String>) {
val array = arrayOf(1, 2, 3, 4, 5, 6)
print (array.slice(1..4)) // [2, 3, 4, 5]
}
انظر أيضًا
- الدالة
sliceArray() : تقطع جزءًا محدَّدًا من المصفوفة التي استُدعيت معها ثمَّ تعيده في مصفوفة أو قائمة بحسب الوسيط الممرر إليها. - التابع
Array.get(): تجلب قيمة العنصر في المصفوفة عند الفهرس المُحدَّد. - الدالة
indexOf(): تجلب فهرس أول ظهور لعنصر محدَّد من المصفوفة أو المجموعة أو القائمة التي استُدعيت معها. - الخاصية
indices: تجلب الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection).