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

من موسوعة حسوب
< Kotlin‏ | Array
اذهب إلى التنقل اذهب إلى البحث
ط
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع Array.get()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎Array.get()‎</code> في Kotlin}}</noinclude>
يعيد التابع <code>Array.get()‎</code> قيمة العنصر عند الفهرس index المُحدَّد في المصفوفة، ويمكن أيضًا استدعاء هذا التابع باستخدام معامل  الفهرسة (index operator) بالشكل:<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>get()</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)
 
+
    println(array.get(2)) // 7
println(array.get(2)) // 7
+
    println(array[1]) // 5
println(array[1]) // 5
 
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* الخاصية <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
+
* الخاصيّة <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
* التابع <code>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 Methods]]
+
[[تصنيف: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) المُحدَّد في المصفوفة.

مصادر