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

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
ط مراجعة وتدقيق.
طلا ملخص تعديل
 
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>copyOf()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>copyOf()‎</code> في Kotlin}}</noinclude>
تنسخ الدالة <code>copyOf()‎</code> كامل [[Kotlin/Array|المصفوفة]] التي استُدعيت معها أو جزءًا منها.     
تنسخ الدالة <code>copyOf()‎</code> كامل [[Kotlin/Array|المصفوفة]] التي استُدعيت معها أو جزءًا منها.     


سطر 27: سطر 27:
inline fun <T> Array<T>.copyOf(newSize: Int): Array<T?>
inline fun <T> Array<T>.copyOf(newSize: Int): Array<T?>
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]).
</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]).
== المعاملات ==
=== <code>newSize</code> ===
عدد صحيح يمثل الحجم الجديد للمصفوفة المراد نسخها.


== القيم المعادة ==
== القيم المعادة ==
يُعاد نسخةٌ جديدةٌ لكامل [[Kotlin/Array|المصفوفة]] التي استدعيت الدالة معها، أو لجزء محدَّد منها إن أعطي المعامل <code>newSize</code>.
يُعاد نسخةٌ جديدةٌ لكامل [[Kotlin/Array|المصفوفة]] التي استدعيت الدالة معها، أو لجزء محدَّد منها إن أعطي المعامل <code>newSize</code>.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()copyOf</code> مع المصفوفات ===
استخدام الدالة <code>()copyOf</code> مع المصفوفات:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()copyOf</code> لإنشاء نسخة من هذه المصفوفة باسم <code>array2</code>. تستعمل بعد ذلك الدالة <code>[[Kotlin/collections/contentToString|()contentToString]]</code> لطبع سلسلة نصية تمثل المصفوفة <code>array2</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.copyOf()
    val array2 = array.copyOf()
println(array2.contentToString()) // [1, 2, 3, 4]
 
    println(array2.contentToString()) // [1, 2, 3, 4]
}
}
</syntaxhighlight>
</syntaxhighlight>استخدام الدالة <code>()copyOf</code> مع المصفوفات مع تحديد العناصر المراد نسخها:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4)
    val array2 = array.copyOf(2)


===استخدام الدالة <code>()copyOf</code> مع المصفوفات مع تحديد العناصر المراد نسخها   ===
    println(array2.contentToString()) // [1, 2]
تعرِّف الشيفرة الآتية [[Kotlin/Array|مصفوفة]] باسم <code>array</code> باستخدام الدالة <code>()arrayOf</code> ثمَّ تستخدم الدالة <code>()copyOf</code> لنسخ أول عنصرين من تلك المصفوفة وتسميتهما باسم <code>array2</code>. تستعمل بعد ذلك الدالة <code>[[Kotlin/collections/contentToString|()contentToString]]</code> لطبع سلسلة نصية تمثل المصفوفة <code>array2</code> الناتجة:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
val array = arrayOf(1,2,3,4)
val array2 = array.copyOf(2)
println(array2.contentToString()) // [1, 2]
}
}
</syntaxhighlight>
</syntaxhighlight>
سطر 56: سطر 59:


==مصادر==
==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/copy-of.html الدالة copyOf()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/copy-of.html صفحة الدالة copyOf()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Collection]]

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

تنسخ الدالة copyOf()‎ كامل المصفوفة التي استُدعيت معها أو جزءًا منها.  

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

inline fun <T> Array<T>.copyOf(): Array<T> 
inline fun ByteArray.copyOf(): ByteArray 
inline fun ShortArray.copyOf(): ShortArray 
inline fun IntArray.copyOf(): IntArray 
inline fun LongArray.copyOf(): LongArray 
inline fun FloatArray.copyOf(): FloatArray 
inline fun DoubleArray.copyOf(): DoubleArray 
inline fun BooleanArray.copyOf(): BooleanArray
inline fun CharArray.copyOf(): CharArray

inline fun ByteArray.copyOf(newSize: Int): ByteArray 
inline fun ShortArray.copyOf(newSize: Int): ShortArray 
inline fun IntArray.copyOf(newSize: Int): IntArray 
inline fun LongArray.copyOf(newSize: Int): LongArray 
inline fun FloatArray.copyOf(newSize: Int): FloatArray 
inline fun DoubleArray.copyOf(newSize: Int): DoubleArray 
inline fun BooleanArray.copyOf(newSize: Int): BooleanArray 
inline fun CharArray.copyOf(newSize: Int): CharArray 
inline fun <T> Array<T>.copyOf(newSize: Int): Array<T?>

وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع توثيق الدوال المباشرة).

المعاملات

newSize

عدد صحيح يمثل الحجم الجديد للمصفوفة المراد نسخها.

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

يُعاد نسخةٌ جديدةٌ لكامل المصفوفة التي استدعيت الدالة معها، أو لجزء محدَّد منها إن أعطي المعامل newSize.

أمثلة

استخدام الدالة ()copyOf مع المصفوفات:

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4)
    val array2 = array.copyOf()

    println(array2.contentToString()) // [1, 2, 3, 4]
}

استخدام الدالة ()copyOf مع المصفوفات مع تحديد العناصر المراد نسخها:

fun main(args: Array<String>) {
    val array = arrayOf(1, 2, 3, 4)
    val array2 = array.copyOf(2)

    println(array2.contentToString()) // [1, 2]
}

انظر أيضًا

مصادر

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