الفرق بين المراجعتين ل"Kotlin/FloatArray/set"

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

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

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

arr[index]‎ = value

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

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

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

المعاملات

`index`

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

`value`

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

أمثلة

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

import java.util.Arrays

fun main(args: Array<String>) {
    val f: (Int) -> Float = { x -> x * 4f }
    val array = FloatArray(6, f)

    array.set(1, 5.34f)
    array[2] = 98.5f

    println(Arrays.toString(array)) // [0.0, 98.5, 5.34, 12.0, 16.0, 20.0]
}

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع FloatArray.set()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>FloatArray.set()‎</code> في Kotlin}}</noinclude>
-يعين التابع <code>set()‎</code> قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذا التابع باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين <code>[]</code> بالشكل:<syntaxhighlight lang="kotlin">
+تضبط الدالة <code>set()</code>‎ قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
+يمكن الاستعاضة عن هذه الدالة باستخدام آلية الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل:<syntaxhighlight lang="kotlin">
 arr[index]‎ = value
 </syntaxhighlight>
@@ سطر 8: / سطر 10: @@
 operator fun set(index: Int, value: Float)
-</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا.
+</syntaxhighlight>وجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذه الدالة مرتبط بمعامل الفهرسة المذكور سابقًا.
+== المعاملات ==
+=== <code>index</code> ===
+عدد صحيح يمثل فهرس العنصر المراد تغيير قيمته وتعيين القيمة <code>value</code> له.
+=== <code>value</code> ===
+القيمة المراد تعيينها إلى العنصر ذي الفهرس <code>index</code>.
 == أمثلة ==
+استعمال الدالة <code>set()‎</code> لتغيير قيمة العنصر الثاني والثالث إلى 5.34 و 98.5 على التوالي:<syntaxhighlight lang="kotlin">
-=== استخدام التابع <code>set()‎</code> على مصفوفة أعداد صحيحة ===
-تُنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ بالاعتماد على الدالة <code>FloatArray</code>، ثم تعيّن عنصرين من المصفوفة بطريقتين: الأولى باستدعاء التابع <code>set()</code>‎ مباشرةً، والثانية باستخدام معامل الفهرسة (القوسين بالشكل <code>[index]</code>):<syntaxhighlight lang="kotlin">
 import java.util.Arrays
 fun main(args: Array<String>) {
-val array = ByteArray(6)
+    val f: (Int) -> Float = { x -> x * 4f }
+    val array = FloatArray(6, f)
-array.set(2,5)
-array[1] = 98
+     array.set(1, 5.34f)
+    array[2] = 98.5f
-println(Arrays.toString(array)) // [0, 98, 5, 0, 0, 0]
+     println(Arrays.toString(array)) // [0.0, 98.5, 5.34, 12.0, 16.0, 20.0]
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* الخاصيّة <code>[[Kotlin/FloatArray/size|FloatArray.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
+* الصنف <code>‎[[Kotlin/FloatArray|FloatArray]]</code>.
+* الخاصية <nowiki/>[[Kotlin/FloatArray/size|<code>FloatArray.size</code>]]: تمثل عدد العناصر الموجودة في المصفوفة.
+* الدالة <code>[[Kotlin/FloatArray/Init|FloatArray()‎]]</code>: تنشئ <nowiki/>[[Kotlin/Array|مصفوفة]] جديدة من النوع <code>[[Kotlin/FloatArray|FloatArray]]</code> (أي مصفوفة من الأعداد العشرية) بحجم معين، وتحوي قيمًا محدَّدة أو القيم 0.
+* الدالة <code>[[Kotlin/FloatArray/get|()get]]</code>: تجلب عنصرًا ذي فهرس محدد من المصفوفة.
+* الدالة <code>[[Kotlin/FloatArray/iterator|iterator()‎]]</code>: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/set.html التابع FloatArray.set في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float-array/set.html صفحة الدالة ()FloatArray.set في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin FloatArray]]