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

المراجعة الحالية بتاريخ 06:41، 9 سبتمبر 2018

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

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

value = arr[index]‎

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

operator fun get(index: Int): Char

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

المعاملات

`index`

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

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

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

أمثلة

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

fun main(args: Array<String>) {
    val int: (Int) -> Char = { x -> (x + 97).toChar() }
    val array = CharArray(6, int)

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

انظر أيضًا

الخاصية CharArray.size: تمثل عدد العناصر الموجودة في المصفوفة.
الدالة CharArray()‎: تنشئ مصفوفة جديدة من النوع CharArray (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة '‎\u0000' التي تمثل حرفًا عدميًّا.
الدالة iterator()‎: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.

الدالة ()set: تضبط قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع CharArray.get()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharArray.get()‎</code> في 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): Char
-</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا.
+</syntaxhighlight>وجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذه الدالة مرتبطة بمعامل الفهرسة الذي ذكرناه آنفًا.
+== المعاملات ==
+=== <code>index</code> ===
+عدد صحيح يمثل فهرس العنصر المراد جلبه.
 == القيم المعادة ==
-العنصر عند الفهرس (index) المُحدَّد في المصفوفة.
+يعاد العنصر ذو الفهرس <code>index</code> المحدِّد والموجود في المصفوفة المعطاة.
 == أمثلة ==
+استعمال الدالة <code>get()‎</code> لجلب العنصر الثالث من مصفوفة من النوع <code>[[Kotlin/CharArray|CharArray]]</code>:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+    val int: (Int) -> Char = { x -> (x + 97).toChar() }
+    val array = CharArray(6, int)
-=== استخدام التابع <code>get()‎</code> على مصفوفة أعداد صحيحة ===
+     println(array.get(2)) // c
-تُنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ بالاعتماد على الدالة <code>CharArray</code>، ثم تُطبع قيمة عنصرين من المصفوفة بطريقتين: الأولى باستدعاء التابع <code>get()</code>‎ مباشرةً، والثانية باستخدام معامل الفهرسة (القوسين بالشكل <code>[index]</code>):<syntaxhighlight lang="kotlin">
+    println(array[2])     // c
-fun main(args: Array<String>) {
-val f: (Int) -> Char = { x -> (x+97).toChar() }
-val array = CharArray(6, f)
-print(array.get(2)) // c
-println(array[1]) // b
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* الخاصيّة <code>[[Kotlin/CharArray/size|CharArray.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
+* الخاصية <nowiki/>[[Kotlin/CharArray/size|<code>CharArray.size</code>]]: تمثل عدد العناصر الموجودة في المصفوفة.
-* التابع <code>[[Kotlin/CharArray/set|CharArray.set]]()‎</code>: يُعيّن قيمة العنصر عند الفهرس (index) المُحدَّد في المصفوفة.
+* الدالة <code>[[Kotlin/CharArray/Init|CharArray()‎]]</code>: تنشئ <nowiki/>[[Kotlin/Array|مصفوفة]] جديدة من النوع <code>[[Kotlin/CharArray|CharArray]]</code> (أي مصفوفة من الحروف) بحجم معين، وتحوي قيمًا محدَّدة أو القيمة <code>'‎\u0000'</code> التي تمثل حرفًا عدميًّا.
+* الدالة <code>[[Kotlin/CharArray/iterator|iterator()‎]]</code>: تنشئ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه.
+*الدالة <code>[[Kotlin/CharArray/set|()set]]</code>: تضبط قيمة عنصر ذي فهرس محدد موجود في المصفوفة المستدعاة معه.
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-array/get.html التابع CharArray.get في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-array/get.html صفحة الدالة ()CharArray.get في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]