الفرق بين المراجعتين لصفحة: «Kotlin/collections/copyOfRange»
< Kotlin | collections
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>copyOfRange()</code> في | <noinclude>{{DISPLAYTITLE: الدالة <code>copyOfRange()</code> في Kotlin}}</noinclude> | ||
تنسخ الدالة <code>copyOfRange()</code> مجالًا محدَّدًا من [[Kotlin/Array|المصفوفة]] التي استُدعيت معها. | تنسخ الدالة <code>copyOfRange()</code> مجالًا محدَّدًا من [[Kotlin/Array|المصفوفة]] التي استُدعيت معها. | ||
| سطر 41: | سطر 41: | ||
): CharArray | ): CharArray | ||
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]). | </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]). | ||
== المعاملات == | |||
=== <code>fromIndex</code> === | |||
عدد صحيح يشير إلى العنصر الذي يمثل بداية المجال المراد نسخه. | |||
=== <code>toIndex</code> === | |||
عدد صحيح يشير إلى العنصر الذي يمثل نهاية المجال المراد نسخه (لا يدخل هذا العنصر ضمن المجال). | |||
== القيم المعادة == | == القيم المعادة == | ||
| سطر 48: | سطر 56: | ||
تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()copyOfRange</code> لنسخ العنصر الثاني والثالث من تلك [[Kotlin/Array|المصفوفة]] وتطبع سلسلة نصية تمثل هذه العناصر المنسوخة بواسطة الدالة <code>[[Kotlin/collections/contentToString|()contentToString]]</code>:<syntaxhighlight lang="kotlin"> | تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()copyOfRange</code> لنسخ العنصر الثاني والثالث من تلك [[Kotlin/Array|المصفوفة]] وتطبع سلسلة نصية تمثل هذه العناصر المنسوخة بواسطة الدالة <code>[[Kotlin/collections/contentToString|()contentToString]]</code>:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val array = arrayOf(1,2,3,4) | val array = arrayOf(1, 2, 3, 4) | ||
val array2 = array.copyOfRange(1,3) | val array2 = array.copyOfRange(1, 3) | ||
println(array2.contentToString()) // [2, 3] | println(array2.contentToString()) // [2, 3] | ||
| سطر 62: | سطر 70: | ||
==مصادر== | ==مصادر== | ||
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/copy-of-range.html الدالة copyOfRange() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/copy-of-range.html صفحة الدالة copyOfRange() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف:Kotlin Function]] | ||
[[تصنيف:Kotlin Collection]] | |||
المراجعة الحالية بتاريخ 07:37، 8 سبتمبر 2018
تنسخ الدالة copyOfRange() مجالًا محدَّدًا من المصفوفة التي استُدعيت معها.
البنية العامة
inline fun <T> Array<T>.copyOfRange(
fromIndex: Int,
toIndex: Int
): Array<T>
inline fun ByteArray.copyOfRange(
fromIndex: Int,
toIndex: Int
): ByteArray
inline fun ShortArray.copyOfRange(
fromIndex: Int,
toIndex: Int
): ShortArray
inline fun IntArray.copyOfRange(
fromIndex: Int,
toIndex: Int
): IntArray
inline fun LongArray.copyOfRange(
fromIndex: Int,
toIndex: Int
): LongArray
inline fun FloatArray.copyOfRange(
fromIndex: Int,
toIndex: Int
): FloatArray
inline fun DoubleArray.copyOfRange(
fromIndex: Int,
toIndex: Int
): DoubleArray
inline fun BooleanArray.copyOfRange(
fromIndex: Int,
toIndex: Int
): BooleanArray
inline fun CharArray.copyOfRange(
fromIndex: Int,
toIndex: Int
): CharArray
وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة).
المعاملات
fromIndex
عدد صحيح يشير إلى العنصر الذي يمثل بداية المجال المراد نسخه.
toIndex
عدد صحيح يشير إلى العنصر الذي يمثل نهاية المجال المراد نسخه (لا يدخل هذا العنصر ضمن المجال).
القيم المعادة
تُعاد مصفوفةٌ جديدةٌ تحتوي على نسخة من العناصر الواقعة بين العنصر ذي الفهرس fromIndex وحتى العنصر ذي الفهرس toIndex في المصفوفة المعطاة.
أمثلة
استخدام الدالة ()copyOf مع المصفوفات
تعرِّف الشيفرة الآتية مصفوفة باسم array باستخدام الدالة ()arrayOf ثمَّ تستخدم الدالة ()copyOfRange لنسخ العنصر الثاني والثالث من تلك المصفوفة وتطبع سلسلة نصية تمثل هذه العناصر المنسوخة بواسطة الدالة ()contentToString:
fun main(args: Array<String>) {
val array = arrayOf(1, 2, 3, 4)
val array2 = array.copyOfRange(1, 3)
println(array2.contentToString()) // [2, 3]
}
انظر أيضًا
- الدالة
copyOf(): تنسخ الدالة كامل المصفوفة التي استُدعيت معها أو جزءًا منها. - التابع
Array.get(): يعيد قيمة العنصر ذي الفهرس (index) المعطى الموجود في مصفوفة. - الدالة
count(): تعيد عدد عناصر المصفوفة أو المجموعة أو الخريطة التي استُدعيت معها.