الفرق بين المراجعتين لصفحة: «Kotlin/collections/sliceArray»
< Kotlin | collections
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>sliceArray()</code> في لغة Kotlin}}</noinclude><blockquote>تعيد الدالة<code>sliceArray()</code>Kotli...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>sliceArray()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>sliceArray()</code> في لغة Kotlin}}</noinclude> | ||
تعيد الدالة<code>sliceArray()</code>[[Kotlin/List|لائحة]] أو [[Kotlin/Array|مصفوفة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر <code>indices</code>. | |||
==البنية العامة== | ==البنية العامة== | ||
في حال تمرير كائن من النوع <code>Collection</code> كوسيط إلى الدالة <code>sliceArray()</code>، فستعيد [[Kotlin/Array|مصفوفة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر <code>indices</code>:<nowiki/><nowiki/><syntaxhighlight lang="kotlin"> | |||
fun <T> Array< | fun <T> Array<T>.sliceArray( | ||
fun ByteArray. | indices: Collection<Int> | ||
fun ShortArray. | ): Array<T> | ||
fun IntArray. | fun ByteArray.sliceArray(indices: Collection<Int>): ByteArray | ||
fun LongArray. | fun ShortArray.sliceArray( | ||
fun FloatArray. | indices: Collection<Int> | ||
fun DoubleArray. | ): ShortArray | ||
fun BooleanArray. | fun IntArray.sliceArray(indices: Collection<Int>): IntArray | ||
fun CharArray. | fun LongArray.sliceArray(indices: Collection<Int>): LongArray | ||
fun FloatArray.sliceArray( | |||
</syntaxhighlight> | indices: Collection<Int> | ||
): FloatArray | |||
fun DoubleArray.sliceArray( | |||
indices: Collection<Int> | |||
): DoubleArray | |||
fun BooleanArray.sliceArray( | |||
indices: Collection<Int> | |||
): BooleanArray | |||
fun CharArray.sliceArray(indices: Collection<Int>): CharArray | |||
</syntaxhighlight>في حال تمرير [[Kotlin/ranges|مجال]] <code>indices</code> كوسيط إلى الدالة <code>sliceArray()</code>، فستعيد [[Kotlin/List|لائحة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر <code>indices</code>:<nowiki/><nowiki/><syntaxhighlight lang="kotlin"> | |||
fun <T> Array<out T>.slice(indices: Iterable<Int>): List<T> (source) | fun <T> Array<out T>.slice(indices: Iterable<Int>): List<T> (source) | ||
fun ByteArray.slice(indices: Iterable<Int>): List<Byte> (source) | fun ByteArray.slice(indices: Iterable<Int>): List<Byte> (source) | ||
| سطر 26: | سطر 37: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المٌعادة== | ==القيم المٌعادة== | ||
[[Kotlin/List|لائحة]] | تعيد الدالة<code>sliceArray()</code>[[Kotlin/List|لائحة]] أو [[Kotlin/Array|مصفوفة]] تحتوي عناصر [[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر <code>indices</code>. | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()sliceArray</code> مع المصفوفات=== | ===استخدام الدالة <code>()sliceArray</code> مع المصفوفات=== | ||
تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]]<nowiki/>باسم <code>array</code> مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة<code>()sliceArray</code> على <code>array</code> | تعرف الشيفرة الآتية <nowiki/>[[Kotlin/Array|مصفوفة]]<nowiki/>باسم <code>array</code> مكونة من ستة عناصر باستخدام الدالة <code>()arrayOf</code>، ثم تستخدم الدالة<code>()sliceArray</code> على <code>array</code> مع تمرير [[Kotlin/ranges|مجال]]، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
import java.util.Arrays | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val array = arrayOf(1, 2, 3, 4, 5, 6) | val array = arrayOf(1, 2, 3, 4, 5, 6) | ||
print (array. | print (Arrays.toString(array.sliceArray(1..3))) // [2, 3, 4] | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===أنظر أيضًا=== | ===أنظر أيضًا=== | ||
*<code>[[Kotlin/collections/ | *<code>[[Kotlin/collections/slice|slice()]]</code>:تعيد العنصر الوحيد الموجود في [[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/collections|المجموعة]] أو [[Kotlin/List|اللائحة]] التي استُدعيت عبرها، وفي حال تمرير شرط منطقي <code>predicate</code> كمعامل (parameter) فستعيد العنصر الوحيد الذي يحقق ذلك الشرط المنطقي. أمّا في حال كان الكائن الذي استُدعيت عبره يحتوي أكثر من عنصر واحد (يحقق <code>predicate</code> في حال تمريرها) أو لا يحتوي أي واحد (يحقق <code>predicate</code> في حال تمريرها) فستعيد القيمة المعدومة <code>null</code>. | ||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/slice.html الدالة sliceArray() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/slice.html الدالة sliceArray() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 12:34، 4 يونيو 2018
تعيد الدالةsliceArray()لائحة أو مصفوفة تحتوي عناصر المصفوفة التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر indices.
البنية العامة
في حال تمرير كائن من النوع Collection كوسيط إلى الدالة sliceArray()، فستعيد مصفوفة تحتوي عناصر المصفوفة التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر indices:
fun <T> Array<T>.sliceArray(
indices: Collection<Int>
): Array<T>
fun ByteArray.sliceArray(indices: Collection<Int>): ByteArray
fun ShortArray.sliceArray(
indices: Collection<Int>
): ShortArray
fun IntArray.sliceArray(indices: Collection<Int>): IntArray
fun LongArray.sliceArray(indices: Collection<Int>): LongArray
fun FloatArray.sliceArray(
indices: Collection<Int>
): FloatArray
fun DoubleArray.sliceArray(
indices: Collection<Int>
): DoubleArray
fun BooleanArray.sliceArray(
indices: Collection<Int>
): BooleanArray
fun CharArray.sliceArray(indices: Collection<Int>): CharArray
في حال تمرير مجال indices كوسيط إلى الدالة sliceArray()، فستعيد لائحة تحتوي عناصر المصفوفة التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر indices:
fun <T> Array<out T>.slice(indices: Iterable<Int>): List<T> (source)
fun ByteArray.slice(indices: Iterable<Int>): List<Byte> (source)
fun ShortArray.slice(indices: Iterable<Int>): List<Short> (source)
fun IntArray.slice(indices: Iterable<Int>): List<Int> (source)
fun LongArray.slice(indices: Iterable<Int>): List<Long> (source)
fun FloatArray.slice(indices: Iterable<Int>): List<Float> (source)
fun DoubleArray.slice(indices: Iterable<Int>): List<Double> (source)
fun BooleanArray.slice(indices: Iterable<Int>): List<Boolean> (source)
fun CharArray.slice(indices: Iterable<Int>): List<Char> (source)
fun <T> List<T>.slice(indices: Iterable<Int>): List<T>
القيم المٌعادة
تعيد الدالةsliceArray()لائحة أو مصفوفة تحتوي عناصر المصفوفة التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر indices.
أمثلة
استخدام الدالة ()sliceArray مع المصفوفات
تعرف الشيفرة الآتية مصفوفةباسم array مكونة من ستة عناصر باستخدام الدالة ()arrayOf، ثم تستخدم الدالة()sliceArray على array مع تمرير مجال، ثم تطبع الناتج:
import java.util.Arrays
fun main(args: Array<String>) {
val array = arrayOf(1, 2, 3, 4, 5, 6)
print (Arrays.toString(array.sliceArray(1..3))) // [2, 3, 4]
}
أنظر أيضًا
slice():تعيد العنصر الوحيد الموجود في المصفوفة أو المجموعة أو اللائحة التي استُدعيت عبرها، وفي حال تمرير شرط منطقيpredicateكمعامل (parameter) فستعيد العنصر الوحيد الذي يحقق ذلك الشرط المنطقي. أمّا في حال كان الكائن الذي استُدعيت عبره يحتوي أكثر من عنصر واحد (يحققpredicateفي حال تمريرها) أو لا يحتوي أي واحد (يحققpredicateفي حال تمريرها) فستعيد القيمة المعدومةnull.