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

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


== أمثلة ==
== أمثلة ==
 
تُنشِئ  الشيفرة التالية مصفوفةً من أربعة عناصر من الأعداد الصحيحة (وذلك بالاستفادة من الدالة <code>arrayOf</code>) ثم تستخدم الدالة <code>set()‎</code> لتغيير قيمة عنصرين فيها بطريقتين: الأولى باستخدام الاستدعاء المباشر للدالة والثانية باستخدام معامل الفهرسة (بالشكل <code>arr[index] = value</code>‎) كما يلي:<syntaxhighlight lang="kotlin">
=== استخدام التابع <code>set()‎</code> في المصفوفة ===
تُنشِئ  الشيفرة الآتية مصفوفةً من أربعة عناصر من الأعداد الصحيحة (وذلك بالاستفادة من الدالة <code>arrayOf</code>) ثم تستخدم التابع <code>set()‎</code> لتغيير قيمة عنصرين فيها بطريقتين: الأولى باستخدام الاستدعاء المباشر للتابع والثانية باستخدام معامل الفهرسة (<code>arr[index] = value</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)
سطر 24: سطر 30:


== انظر أيضًا ==
== انظر أيضًا ==
* الخاصية <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
* الخاصيّة <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
* التابع <code>[[Kotlin/Array/get|Array.get()‎]]</code>: يعيد العنصر عند الفهرس (index) المُحدَّد من المصفوفة.
* الدالة <code>[[Kotlin/Array/get|Array.get()‎]]</code>: تعيد العنصر من المصفوفة عند الفهرس (index) المُحدَّد.


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

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

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

arr[index] = value

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

operator fun set(index: Int, value: T)

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

المعاملات

index

عدد صحيح يمثل فهرس العنصر المراد تغيير أو تعيين القيمة value له.

value

القيمة المراد تعيينها إلى العنصر ذي الفهرس index.

أمثلة

تُنشِئ  الشيفرة التالية مصفوفةً من أربعة عناصر من الأعداد الصحيحة (وذلك بالاستفادة من الدالة arrayOf) ثم تستخدم الدالة set()‎ لتغيير قيمة عنصرين فيها بطريقتين: الأولى باستخدام الاستدعاء المباشر للدالة والثانية باستخدام معامل الفهرسة (بالشكل arr[index] = value‎) كما يلي:

fun main(args: Array<String>) {
    val array = arrayOf(4,5,7,9)
    array.set(2,100) // ستصبح القيمة 100 في العنصر ذي الفهرس 2
    array[1]=33 // ستصبح القيمة 33 في العنصر ذي الفهرس 1

    for(element in array)  
        print("$element ")  // 4 33 100 9
}

انظر أيضًا

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

مصادر