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

مراجعة 12:08، 10 أغسطس 2018

يجلب التابع get()‎ عنصرًا ذي فهرس محدد من المصفوفة.

يمكن الاستعاضة عن هذا التابع باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل:

value = arr[index]‎

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

operator fun get(index: Int): Byte

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

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

يعاد العنصر ذو الفهرس index المحدِّد والموجود في المصفوفة المعطاة.

أمثلة

استعمال التابع get()‎ لجلب العنصر الثالث من مصفوفة من النوع ByteArray:

import java.util.Arrays

fun main(args: Array<String>) {
    val f: (Int) -> Byte = { x -> x.toByte() }
    val array = ByteArray(6, f)

    println(array.get(2)) // 2
    println(array[2])     // 2
}

انظر أيضًا

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

مصادر

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

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