الفرق بين المراجعتين لصفحة: «Kotlin/Array/get»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <noinclude>{{DISPLAYTITLE: الدالة <code>Array.get()</code> في Kotlin}}</noinclude> | ||
تعيد الدالة <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"> | |||
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/set|Array.set()]]</code>: تعيّن قيمة العنصر عند الفهرس (index) المُحدَّد في المصفوفة. | ||
== مصادر == | == مصادر == | ||
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/get.html | * [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-array/get.html صفحة الدالة ()Array.get في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin | [[تصنيف: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) المُحدَّد في المصفوفة.