الدالة ‎‎Array.set()‎ في Kotlin

تعيِّن الدالة 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) المُحدَّد.

مصادر

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