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

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

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

يمكن الاستعاضة عن هذه الدالة باستخدام آلية الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل:

arr[index]‎ = value

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

operator fun set(index: Int, value: Char)

وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطة بمعامل الفهرسة المذكور سابقًا.

المعاملات

`index`

عدد صحيح يمثل فهرس العنصر المراد تغيير قيمته وتعيين القيمة value له.

`value`

القيمة المراد تعيينها إلى العنصر ذي الفهرس index.

أمثلة

استعمال الدالة set()‎ لتغيير قيمة العنصر الثاني والثالث إلى 'G' و 'T' على التوالي:

import java.util.Arrays

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

    array.set(1, 'G')
    array[2] = 'T'

    println(Arrays.toString(array)) // [a, G, T, d, e, f]
}

انظر أيضًا

الصنف ‎CharArray.
الدالة CharArray()‎: تنشئ مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '‎\u0000' التي تمثل حرفًا عدميًّا.
الدالة ()get: تجلب عنصرًا ذي فهرس محدد من المصفوفة.
الدالة iterator()‎: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
الخاصية CharArray.size: تمثل عدد العناصر الموجودة في المصفوفة.

مصادر

صفحة الدالة ()CharArray.set في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>CharArray.set()‎</code> في Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharArray.set()‎</code> في Kotlin}}</noinclude>
-يضبط التابع <code>set()</code>‎ قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
+تضبط الدالة <code>set()</code>‎ قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
-يمكن الاستعاضة عن هذا التابع باستخدام آلية الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل:<syntaxhighlight lang="kotlin">
+يمكن الاستعاضة عن هذه الدالة باستخدام آلية الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل:<syntaxhighlight lang="kotlin">
 arr[index]‎ = value
 </syntaxhighlight>
@@ سطر 10: / سطر 10: @@
 operator fun set(index: Int, value: Char)
-</syntaxhighlight>وجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا.
+</syntaxhighlight>وجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذه الدالة مرتبطة بمعامل الفهرسة المذكور سابقًا.
+== المعاملات ==
+=== <code>index</code> ===
+عدد صحيح يمثل فهرس العنصر المراد تغيير قيمته وتعيين القيمة <code>value</code> له.
+=== <code>value</code> ===
+القيمة المراد تعيينها إلى العنصر ذي الفهرس <code>index</code>.
 == أمثلة ==
-استعمال التابع <code>set()‎</code> لتغيير قيمة العنصر الثاني والثالث إلى <code>'G'</code> و <code>'T'</code> على التوالي:<syntaxhighlight lang="kotlin">
+استعمال الدالة <code>set()‎</code> لتغيير قيمة العنصر الثاني والثالث إلى <code>'G'</code> و <code>'T'</code> على التوالي:<syntaxhighlight lang="kotlin">
 import java.util.Arrays
@@ سطر 30: / سطر 38: @@
 * الصنف <code>‎[[Kotlin/CharArray|CharArray]]</code>.
 * الدالة <code>[[Kotlin/CharArray/Init|CharArray()‎]]</code>: تنشئ <nowiki/>[[Kotlin/Array|مصفوفة]] جديدة من النوع <code>[[Kotlin/CharArray|CharArray]]</code> (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة <code>'‎\u0000'</code> التي تمثل حرفًا عدميًّا.
-* التابع <code>[[Kotlin/CharArray/get|()get]]</code>: يجلب عنصرًا ذي فهرس محدد من المصفوفة.
+* الدالة <code>[[Kotlin/CharArray/get|()get]]</code>: تجلب عنصرًا ذي فهرس محدد من المصفوفة.
-* التابع <code>[[Kotlin/CharArray/iterator|iterator()‎]]</code>: ينشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
+* الدالة <code>[[Kotlin/CharArray/iterator|iterator()‎]]</code>: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
 * الخاصية <nowiki/>[[Kotlin/CharArray/size|<code>CharArray.size</code>]]: تمثل عدد العناصر الموجودة في المصفوفة.
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-array/set.html صفحة التابع ()CharArray.set في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-array/set.html صفحة الدالة ()CharArray.set في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin CharArray]]