الفرق بين المراجعتين ل"Kotlin/Array/get"

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

تعيد الدالة Array.get()‎ قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذه الدالة باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين [] بالشكل:

value = arr[index]‎

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

operator fun get(index: Int): T

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

المعاملات

`index`

عدد صحيح يمثل فهرس العنصر المراد جلبه.

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

يعاد العنصر عند الفهرس (index) المُحدَّد في المصفوفة.

أمثلة

تُنشِئ الشيفرة الآتية مصفوفةً من أربعة أعدادٍ صحيحةٍ بالاعتماد على الدالة arrayOf، ثم تُطبع قيمة عنصرين من المصفوفة بطريقتين: الأولى باستدعاء الدالة get()‎ مباشرةً، والثانية باستخدام معامل الفهرسة (القوسين بالشكل [index]):

fun main(args: Array<String>) {
    val array = arrayOf(4,5,7,9)
    println(array.get(2)) // 7
    println(array[1]) // 5
}

انظر أيضًا

الخاصيّة Array.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
الدالة Array.set()‎: تعيّن قيمة العنصر عند الفهرس (index) المُحدَّد في المصفوفة.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع Array.get()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎Array.get()‎</code> في Kotlin}}</noinclude>
-يعيد التابع Array.get()‎ قيمة العنصر عند الفهرس index المُحدَّد في المصفوفة، ويمكن أيضًا استدعاء هذا التابع باستخدام معامل  الفهرسة (index operator) بالشكل:
+تعيد الدالة <code>Array.get()‎</code> قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذه الدالة باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين <code>[]</code> بالشكل:<syntaxhighlight lang="kotlin">
 value = arr[index]‎
+</syntaxhighlight>
 == البنية العامة ==
+<syntaxhighlight lang="kotlin">
 operator fun get(index: Int): T
+</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذه الدالة مرتبط بمعامل الفهرسة المذكور سابقًا.
+== المعاملات ==
-ويُلاحظ وجود الكلمة المفتاحية operator للدلالة على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا.
+=== <code>index</code> ===
+عدد صحيح يمثل فهرس العنصر المراد جلبه.
 == القيم المعادة ==
-العنصر عند الفهرس index المُحدَّد في المصفوفة.
+يعاد العنصر عند الفهرس (index) المُحدَّد في المصفوفة.
 == أمثلة ==
+تُنشِئ الشيفرة الآتية مصفوفةً من أربعة أعدادٍ صحيحةٍ بالاعتماد على الدالة <code>arrayOf</code>، ثم تُطبع قيمة عنصرين من المصفوفة بطريقتين: الأولى باستدعاء الدالة <code>get()</code>‎ مباشرةً، والثانية باستخدام معامل الفهرسة (القوسين بالشكل <code>[index]</code>):<syntaxhighlight lang="kotlin">
-=== استخدام التابع get()‎ على مصفوفة ===
-تُنشئ الشيفرة الآتية مصفوفة من أربعة أعداد ثم تُطبع قيمة عنصرين من المصفوفة بطريقتين: الأولى باستدعاء التابع get()‎ مباشرة، والثانية باستخدام معامل الفهرسة:
 fun main(args: Array<String>) {
+    val array = arrayOf(4,5,7,9)
-val array = arrayOf(4,5,7,9)
+    println(array.get(2)) // 7
+    println(array[1]) // 5
-println(array.get(2)) // 7
-println(array[1]) // 5
 }
+</syntaxhighlight>
 == انظر أيضًا ==
-* الخاصية Array.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
+* الخاصيّة <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
-* التابع Array.set()‎: يُعيّن قيمة العنصر عند الفهرس index المُحدَّد في المصفوفة.
+* الدالة <code>[[Kotlin/Array/set|Array.set()‎]]</code>: تعيّن قيمة العنصر عند الفهرس (index) المُحدَّد في المصفوفة.
 == مصادر ==
-* التابع Array.get في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/get.html صفحة الدالة ()Array.get في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Methods]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Array]]