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

من موسوعة حسوب
< Kotlin‏ | Array
طلا ملخص تعديل
طلا ملخص تعديل
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>‎‎Array.get()‎</code> في Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎Array.get()‎</code> في Kotlin}}</noinclude>
يعيد التابع <code>Array.get()‎</code> قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذا التابع باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين <code>[]</code> بالشكل:<syntaxhighlight lang="kotlin">
تعيد الدالة <code>Array.get()‎</code> قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، ويمكن أيضًا استدعاء هذه الدالة باستخدام معامل الفهرسة (index operator) المتمثل بالقوسين <code>[]</code> بالشكل:<syntaxhighlight lang="kotlin">
value = arr[index]‎
value = arr[index]‎
</syntaxhighlight>
</syntaxhighlight>
سطر 7: سطر 7:
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
operator fun get(index: Int): T
operator fun get(index: Int): T
</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا.
</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذه الدالة مرتبط بمعامل الفهرسة المذكور سابقًا.
 
== المعاملات ==
 
=== <code>index</code> ===
عدد صحيح يمثل فهرس العنصر المراد جلبه.


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


== أمثلة ==
== أمثلة ==
 
تُنشِئ الشيفرة الآتية مصفوفةً من أربعة أعدادٍ صحيحةٍ بالاعتماد على الدالة <code>arrayOf</code>، ثم تُطبع قيمة عنصرين من المصفوفة بطريقتين: الأولى باستدعاء الدالة <code>get()</code>‎ مباشرةً، والثانية باستخدام معامل الفهرسة (القوسين بالشكل <code>[index]</code>):<syntaxhighlight lang="kotlin">
=== استخدام التابع <code>get()‎</code> على مصفوفة أعداد صحيحة ===
تُنشِئ الشيفرة الآتية مصفوفةً من أربعة أعدادٍ صحيحةٍ بالاعتماد على الدالة <code>arrayOf</code>، ثم تُطبع قيمة عنصرين من المصفوفة بطريقتين: الأولى باستدعاء التابع <code>get()</code>‎ مباشرةً، والثانية باستخدام معامل الفهرسة (القوسين بالشكل <code>[index]</code>):<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
     val array = arrayOf(4,5,7,9)
     val array = arrayOf(4,5,7,9)
سطر 25: سطر 28:
== انظر أيضًا ==
== انظر أيضًا ==
* الخاصيّة <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
* الخاصيّة <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
* التابع <code>[[Kotlin/Array/set|Array.set()‎]]</code>: يُعيّن قيمة العنصر عند الفهرس (index) المُحدَّد في المصفوفة.
* الدالة <code>[[Kotlin/Array/set|Array.set()‎]]</code>: تعيّن قيمة العنصر عند الفهرس (index) المُحدَّد في المصفوفة.


== مصادر ==
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/get.html التابع ()Array.get في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/get.html صفحة الدالة ()Array.get في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Array]]

المراجعة الحالية بتاريخ 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) المُحدَّد في المصفوفة.

مصادر