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

المراجعة الحالية بتاريخ 04:02، 9 سبتمبر 2018

تنشئ الدالة ByteArray()‎ البانية مصفوفة جديدة من النوع ByteArray (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0.

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

ByteArray(size: Int, init: (Int) -> Byte)
ByteArray(size: Int)

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

المعاملات

`size`

عدد صحيح يمثل حجم المصفوفة الجديدة المراد إنشاؤها.

`init`

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

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

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

أمثلة

استعمال الدالة ByteArray()‎ لإنشاء مصفوفة من البايتات (أي من النوع ByteArray) مؤلفة من ستة عناصر قيمة كلٍّ منها 0:

import java.util.Arrays

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

    print(Arrays.toString(array)) // [0, 0, 0, 0, 0, 0]
}

استعمال الدالة ByteArray()‎ لإنشاء مصفوفة من البايتات (أي من النوع ByteArray) مؤلفة من ستة عناصر قيمة كلٍّ منها نفس قيمة فهرسها:

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]
}

انظر أيضًا

الصنف ‎ByteArray.
التابع ()get: يجلب عنصرًا ذي فهرس محدد من المصفوفة.
التابع iterator()‎: ينشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
التابع set()‎: يضبط قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
الخاصية size: تمثل عدد العناصر الموجودة في المصفوفة.
الأصناف والبواني (constructors) في لغة Kotlin.

مصادر

صفحة <init> من الصنف ByteArray في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التهيئة الأولية <init> عبر التابع ByteArray.Array()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التهيئة الأولية <code><init></code> للصنف <code>ByteArray</code> في Kotlin}}</noinclude>
-ينشِئ التابع <code>Array()‎</code> مصفوفةً من النوع <code>ByteArray</code>  بحجم <code>size</code> مُحدَّدٍ، بحيث كل العناصر تساوي <code>0</code>، وفي حال  تمرير دالة كوسيط فسيُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة <code>init</code> المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى.
+تنشئ الدالة <code>ByteArray()‎</code> البانية <nowiki/>[[Kotlin/Array|مصفوفة]] جديدة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code> (أي حجم كل عنصر منها بايتًا واحدًا) بحجم معين، إذ تحوي قيمًا محدَّدة أو القيم 0.
 == البنية العامة ==
@@ سطر 7: / سطر 7: @@
 ByteArray(size: Int)
-</syntaxhighlight>
+</syntaxhighlight>تنشئ هذه الدالة مصفوفة جديدة حجمها بحجم الوسيط <code>size</code>، وتحسب قيمة كل عنصر منها عبر استدعاء الدالة <code>init</code> مع قيمة الفهرس الحالي لكل عنصر. إن لم يُعطَ الوسيط <code>init</code>، فستضبط كل قيم المصفوفة إلى القيمة 0.
+== المعاملات ==
+=== <code>size</code> ===
+عدد صحيح يمثل حجم المصفوفة الجديدة المراد إنشاؤها.
+=== <code>init</code> ===
+دالةٌ تستدعى لحساب قيمة كل عنصر من عناصر المصفوفة المراد إنشاؤها بناءً على قيمة فهرسه.
 == القيم المعادة ==
-مصفوفة من النوع <code>ByteArray</code> بالحجم <code>size</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)
-=== استخدام التابع <code>Array()‎</code> لإنشاء المصفوفة ===
+    print(Arrays.toString(array)) // [0, 0, 0, 0, 0, 0]
-ينشِئ التابع في الشيفرة الآتية مصفوفةً بستة عناصر زوجيّة (نتيجة ضرب فهرس [index] كل عنصرٍ بالعدد <code>2</code> وهذا ما يتم ضمنيًا عبر <code><init></code>) ثم تُطبَع عناصر المصفوفة بالاعتماد على [[Kotlin/control flow|حلقة for]] كما يلي:<syntaxhighlight lang="kotlin">
+}
+</syntaxhighlight>
+استعمال الدالة <code>ByteArray()‎</code> لإنشاء مصفوفة من البايتات (أي من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code>) مؤلفة من ستة عناصر قيمة كلٍّ منها نفس قيمة فهرسها:<syntaxhighlight lang="kotlin">
 import java.util.Arrays
 fun main(args: Array<String>) {
-val array = ByteArray(6)
+    val f: (Int) -> Byte = { x -> x.toByte() }
+    val array = ByteArray(6, f)
-print(Arrays.toString(array)) // [0, 0, 0, 0, 0, 0]
+    print(Arrays.toString(array)) // [0, 1, 2, 3, 4, 5]
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* صفحة الصنف <code>[[Kotlin/ByteArray|ByteArray]]</code>
+* الصنف <code>‎[[Kotlin/ByteArray|ByteArray]]</code>.
-* الخاصيّة <code>[[Kotlin/ByteArray/size|ByteArray.size]]</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/-array/-init-.html التهيئة الأوليّة عبر التابع ByteArray.Array()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/-init-.html صفحة <init> من الصنف ByteArray في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin ByteArray]]