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

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

تنشئ الدالة CharArray()‎ البانية مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '‎\u0000' التي تمثل حرفًا عدميًّا.

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

CharArray(size: Int, init: (Int) -> Char)
CharArray(size: Int)

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

المعاملات

`size`

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

`init`

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

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

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

أمثلة

استعمال الدالة CharArray()‎ لإنشاء مصفوفة تحوي حروفًا معينة:

import java.util.Arrays

fun main(args: Array<String>) {
    val f: (Int) -> Char = { x -> (x + 97).toChar() }
    val array = CharArray(6, f)

    print(Arrays.toString(array)) // [a, b, c, d, e, f]
}

انظر أيضًا

الصنف ‎CharArray.
الدالة ()get: تجلب عنصرًا ذي فهرس محدد من المصفوفة.
الدالة iterator()‎: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.

الدالة ()set: تضبط قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
الخاصية CharArray.size: تمثل عدد العناصر الموجودة في المصفوفة.

الأصناف والبواني (constructors) في لغة Kotlin.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التهيئة الأولية <init> عبر التابع CharArray.Array()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التهيئة الأولية <code><init></code> للصنف <code>CharArray</code> في Kotlin}}</noinclude>
-ينشِئ التابع <code>Array()‎</code> مصفوفةً من النوع <code>CharArray</code>  بحجم <code>size</code> مُحدَّدٍ، بحيث كل العناصر تساوي <code>0</code>، وفي حال  تمرير دالة كوسيط فسيُحسَب كلُّ عنصرٍ فيها عبر استدعاء الدالة <code>init</code> المُحدَّدة، والتي تُعيد عنصرًا في المصفوفة بحسب الفهرس (index) المُعطى.
+تنشئ الدالة <code>CharArray()‎</code> البانية <nowiki/>[[Kotlin/Array|مصفوفة]] جديدة من النوع <code>[[Kotlin/CharArray|CharArray]]</code> (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة <code>'‎\u0000'</code> التي تمثل حرفًا عدميًّا.
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
-ByteArray(size: Int, init: (Int) -> Byte)
+CharArray(size: Int, init: (Int) -> Char)
-ByteArray(size: Int)
+CharArray(size: Int)
-</syntaxhighlight>
+</syntaxhighlight>تنشئ هذه الدالة مصفوفة جديدة حجمها بحجم الوسيط <code>size</code>، وتحسب قيمة كل عنصر منها عبر استدعاء الدالة <code>init</code> مع قيمة الفهرس الحالي لكل عنصر. إن لم يُعطَ الوسيط <code>init</code>، فستُضبَط كل قيم المصفوفة إلى القيمة <code>'‎\u0000'</code>.
+== المعاملات ==
+=== <code>size</code> ===
+عدد صحيح يمثل حجم المصفوفة الجديدة المراد إنشاؤها.
+=== <code>init</code> ===
+دالةٌ تستدعى لحساب قيمة كل عنصر من عناصر المصفوفة المراد إنشاؤها بناءً على قيمة فهرسه.
 == القيم المعادة ==
-مصفوفة من النوع <code>CharArray</code> بالحجم <code>size</code>.
+تعاد مصفوفة جديدة حجمها بحجم الوسيط <code>size</code>، وتحدِّد قيمة كل عنصر منها عبر استدعاء الدالة <code>init</code> مع قيمة الفهرس الحالي لكل عنصر أو تكون قيمة كل عنصر من عناصرها هي <code>'‎\u0000'</code> (إن لم يُعطَ الوسيط <code>init</code>).
 == أمثلة ==
+استعمال الدالة <code>CharArray()‎</code> لإنشاء مصفوفة تحوي حروفًا معينة:<syntaxhighlight lang="kotlin">
-=== استخدام التابع <code>CharArray()‎</code> لإنشاء المصفوفة ===
-ينشِئ التابع <code>CharArray()‎</code> في الشيفرة الآتية مصفوفةً من ستة عناصر ، ثم تُطبَع عناصر المصفوفة:<syntaxhighlight lang="kotlin">
 import java.util.Arrays
 fun main(args: Array<String>) {
-val array = ByteArray(6)
+    val f: (Int) -> Char = { x -> (x + 97).toChar() }
+    val array = CharArray(6, f)
-print(Arrays.toString(array)) // [0, 0, 0, 0, 0, 0]
+    print(Arrays.toString(array)) // [a, b, c, d, e, f]
 }
 </syntaxhighlight>
-=== استخدام التابع <code>ByteArray()‎</code> لإنشاء المصفوفة مع تمرير دالة ===
+== انظر أيضًا ==
-ينشِئ التابع <code>ByteArray()‎</code> في الشيفرة الآتية مصفوفةً بستة عناصر  عبر تمرير الدالة المٌعرفة <code>f،</code>ثم تُطبَع عناصر المصفوفة:<syntaxhighlight lang="kotlin">
+* الصنف <code>‎[[Kotlin/CharArray|CharArray]]</code>.
-import java.util.Arrays
+* الدالة <code>[[Kotlin/CharArray/get|()get]]</code>: تجلب عنصرًا ذي فهرس محدد من المصفوفة.
+* الدالة <code>[[Kotlin/CharArray/iterator|iterator()‎]]</code>: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
-fun main(args: Array<String>) {
+*الدالة <code>[[Kotlin/CharArray/set|()set]]</code>: تضبط قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
-val f: (Int) -> Byte = { x -> x.toByte() }
+*الخاصية <nowiki/>[[Kotlin/CharArray/size|<code>CharArray.size</code>]]: تمثل عدد العناصر الموجودة في المصفوفة.
-val array = ByteArray(6, f)
-print(Arrays.toString(array)) // [0, 1, 2, 3, 4, 5]
-}
-</syntaxhighlight>
-== انظر أيضًا ==
-* صفحة الصنف <code>[[Kotlin/ByteArray|ByteArray]]</code>
-* الخاصيّة <code>[[Kotlin/ByteArray/size|ByteArray.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
 * [[Kotlin/classes|الأصناف والبواني (constructors) في لغة Kotlin.]]
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/-init-.html التهيئة الأوليّة عبر التابع CharArray.Array()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-array/-init-.html صفحة <init> من الصنف CharArray‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin init]]
+[[تصنيف:Kotlin CharArray‎]]