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

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

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

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

arr[index] = value

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

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

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

المعاملات

`index`

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

`value`

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

أمثلة

استعمال التابع set()‎ لتغيير قيمة العنصر الثاني إلى القيمة true:

import java.util.Arrays

fun main(args: Array<String>) {
    val array = BooleanArray(4) { it % 2 == 0 }
    println(Arrays.toString(array)) // [true, false, true, false]
    
    array.set(1, true)
    println(Arrays.toString(array)) // [true, true, true, false]
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع BooleanArray.set()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>BooleanArray.set()‎</code> في Kotlin}}</noinclude>
-يُعيِّن التابع <code>set()</code>‎ قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، كما يمكن أيضًا استدعاء هذا التابع باستخدام الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل:<syntaxhighlight lang="kotlin">
+يضبط التابع <code>set()</code>‎ قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
+يمكن الاستعاضة عن هذا التابع باستخدام آلية الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل:<syntaxhighlight lang="kotlin">
 arr[index] = value
 </syntaxhighlight>
@@ سطر 6: / سطر 8: @@
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
-operator fun set(index: Int, value: T)
+operator fun set(index: Int, value: Boolean)
-</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا.
+</syntaxhighlight>وجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا.
+== المعاملات ==
+=== <code>index</code> ===
+عدد صحيح يمثل فهرس العنصر المراد تغيير قيمته وتعيين القيمة <code>value</code> له.
+=== <code>value</code> ===
+القيمة المراد تعيينها إلى العنصر ذي الفهرس <code>index</code>.
 == أمثلة ==
+استعمال التابع <code>set()‎</code> لتغيير قيمة العنصر الثاني إلى القيمة <code>true</code>:<syntaxhighlight lang="kotlin">
+import java.util.Arrays
-=== استخدام التابع <code>set()‎</code> في المصفوفة ===
-تُنشِئ  الشيفرة الآتية مصفوفةً من أربعة عناصر من الأعداد الصحيحة (وذلك بالاستفادة من الدالة <code>arrayOf</code>) ثم تستخدم التابع <code>set()‎</code> لتغيير قيمة عنصرين فيها بطريقتين: الأولى باستخدام الاستدعاء المباشر للتابع والثانية باستخدام معامل الفهرسة (بالشكل <code>arr[index] = value</code>‎) كما يلي:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-    val array = arrayOf(4,5,7,9)
+    val array = BooleanArray(4) { it % 2 == 0 }
-    array.set(2,100) // ستصبح القيمة 100 في العنصر ذي الفهرس 2
+    println(Arrays.toString(array)) // [true, false, true, false]
-    array[1]=33 // ستصبح القيمة 33 في العنصر ذي الفهرس 1
+    array.set(1, true)
-    for(element in array)
+    println(Arrays.toString(array)) // [true, true, true, false]
-        print("$element ")  // 4 33 100 9
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* الخاصيّة <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
+*الصنف <code>‎‎[[Kotlin/BooleanArray|BooleanArray]]</code>[[Kotlin/BooleanArray|‎]].
-* التابع <code>[[Kotlin/Array/get|Array.get()‎]]</code>: يعيد العنصر من المصفوفة عند الفهرس (index) المُحدَّد.
+*الدالة <code>[[Kotlin/BooleanArray/Init|BooleanArray()‎]]</code>: تنشئ [[Kotlin/Array|مصفوفة]] جديدة بحجم معين تحوي قيمًا منطقية محدَّدة أو القيمة <code>false</code> المنطقية.
+*التابع <code>[[Kotlin/BooleanArray/get|()get]]</code>: يجلب عنصرًا ذي فهرس محدد من المصفوفة.
+*التابع <code>[[Kotlin/BooleanArray/iterator|iterator()‎]]</code>: ينشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
+*الخاصية <code>[[Kotlin/BooleanArray/size|size]]</code>: تمثل عدد العناصر الموجودة في المصفوفة.
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/set.html صفحة التابع BooleanArray.set في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean-array/set.html صفحة التابع ()BooleanArray.set في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin BooleanArray]]