عرض مصدر Kotlin/ByteArray/init

<noinclude>{{DISPLAYTITLE: التهيئة الأولية <code><init></code> للصنف <code>ByteArray</code> في Kotlin}}</noinclude>
تنشئ الدالة <code>ByteArray()‎</code> البانية <nowiki/>[[Kotlin/Array|مصفوفة]] جديدة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code> (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0. 

== البنية العامة ==
<syntaxhighlight lang="kotlin">
ByteArray(size: Int, init: (Int) -> Byte)
ByteArray(size: Int)

</syntaxhighlight>تنشئ هذه الدالة مصفوفة جديدة حجمها بحجم الوسيط <code>size</code>، وتحسب قيمة كل عنصر منها عبر استدعاء الدالة <code>init</code> مع قيمة الفهرس الحالي لكل عنصر. إن لم يُعطَ الوسيط <code>init</code>، فستضبط كل قيم المصفوفة إلى القيمة 0.

== المعاملات ==

=== <code>size</code> ===
عدد صحيح يمثل حجم المصفوفة الجديدة المراد إنشاؤها.

=== <code>init</code> ===
دالةٌ تستدعى لحساب قيمة كل عنصر من عناصر المصفوفة المراد إنشاؤها بناءً على قيمة فهرسه.

== القيم المعادة ==
تعاد مصفوفة جديدة حجمها بحجم الوسيط <code>size</code>، وتحدِّد قيمة كل عنصر منها عبر استدعاء الدالة <code>init</code> مع قيمة الفهرس الحالي لكل عنصر أو تكون قيمة كل عنصر من عناصرها هي 0 (إن لم يُعطَ الوسيط <code>init</code>).

== أمثلة ==
استعمال الدالة <code>ByteArray()‎</code> لإنشاء مصفوفة من البايتات (أي من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code>) مؤلفة من ستة عناصر قيمة كلٍّ منها 0:<syntaxhighlight lang="kotlin">
import java.util.Arrays

fun main(args: Array<String>) {
    val array = ByteArray(6)

    print(Arrays.toString(array)) // [0, 0, 0, 0, 0, 0]
}
</syntaxhighlight>
استعمال الدالة <code>ByteArray()‎</code> لإنشاء مصفوفة من البايتات (أي من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code>) مؤلفة من ستة عناصر قيمة كلٍّ منها نفس قيمة فهرسها:<syntaxhighlight lang="kotlin">
import java.util.Arrays

fun main(args: Array<String>) {
    val f: (Int) -> Byte = { x -> x.toByte() }
    val array = ByteArray(6, f)

    print(Arrays.toString(array)) // [0, 1, 2, 3, 4, 5]
}
</syntaxhighlight>

== انظر أيضًا ==
* الصنف <code>‎[[Kotlin/ByteArray|ByteArray]]</code>.
* التابع <code>[[Kotlin/ByteArray/get|()get]]</code>: يجلب عنصرًا ذي فهرس محدد من المصفوفة.
* التابع <code>[[Kotlin/ByteArray/iterator|iterator()‎]]</code>: ينشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
* التابع <nowiki/>[[Kotlin/ByteArray/set|<code>set()</code>‎]]: يضبط قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
* الخاصية <code>[[Kotlin/ByteArray/size|size]]</code>: تمثل عدد العناصر الموجودة في المصفوفة.
* [[Kotlin/classes|الأصناف والبواني (constructors) في لغة Kotlin.]]

== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/-init-.html صفحة <init> من الصنف ByteArray في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin ByteArray]]