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

من موسوعة حسوب
< Kotlin‏ | Array
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع Array.set()‎ في لغة Kotlin}}</noinclude> يُعيّن التابع Array.set()‎ قيمة العنصر عند الفهر...')
 
ط
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع Array.set()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>‎‎Array.set()</code>‎ في Kotlin}}</noinclude>
يُعيّن التابع Array.set()‎ قيمة العنصر عند الفهرس index المُحدَّد في المصفوفة، ويمكن أيضًا استدعاء هذا التابع باستخدام معامل  الفهرسة (index operator) بالشكل:
+
تعيِّن الدالة <code>Array.set()</code>‎ قيمة العنصر في المصفوفة عند الفهرس (index) المُحدَّد، كما يمكن أيضًا استدعاء هذه الدالة باستخدام الإسناد (assignment) ومعامل الفهرسة (index operator) بالشكل:<syntaxhighlight lang="kotlin">
 
 
 
arr[index] = value
 
arr[index] = value
 +
</syntaxhighlight>
  
 
== البنية العامة ==
 
== البنية العامة ==
 +
<syntaxhighlight lang="kotlin">
 
operator fun set(index: Int, value: T)
 
operator fun set(index: Int, value: T)
 +
</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذه الدالة مرتبط بمعامل الفهرسة المذكور سابقًا.
  
ويُلاحظ وجود الكلمة المفتاحية operator للدلالة على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا.
+
== المعاملات ==
  
== أمثلة ==
+
=== <code>index</code> ===
 +
عدد صحيح يمثل فهرس العنصر المراد تغيير أو تعيين القيمة <code>value</code> له.
  
=== استخدام التابع set()‎ في المصفوفة ===
+
=== <code>value</code> ===
تُنشِئ  الشيفرة الآتية مصفوفةً من أربعة عناصر من الأعداد الصحيحة (وذلك بالاستفادة من الدالة arrayOf) ثم تستخدم التابع set()‎ لتغيير قيمة عنصرين فيها بطريقتين: الأولى باستخدام الاستدعاء المباشر للتابع والثانية باستخدام معامل الفهرسة (arr[index] = value‎) كما يلي:
+
القيمة المراد تعيينها إلى العنصر ذي الفهرس <code>index</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)
 
 
    array.set(2,100) // ستصبح القيمة 100 في العنصر ذي الفهرس 2
 
    array.set(2,100) // ستصبح القيمة 100 في العنصر ذي الفهرس 2
 
 
    array[1]=33 // ستصبح القيمة 33 في العنصر ذي الفهرس 1
 
    array[1]=33 // ستصبح القيمة 33 في العنصر ذي الفهرس 1
  
 
    for(element in array)  
 
    for(element in array)  
 
 
        print("$element ")  // 4 33 100 9
 
        print("$element ")  // 4 33 100 9
 
 
}
 
}
 
+
</syntaxhighlight>
وسينتج عن تنفيذ الشيفرة السابقة طباعة عناصر المصفوفة بالشكل:
 
 
 
4 33 100 9
 
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* الخاصية Array.size: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
+
* الخاصيّة <code>[[Kotlin/Array/size|Array.size]]</code>: تعبِّر عن عدد العناصر الموجودة في المصفوفة.
* التابع Array.get()‎: يعيد العنصر عند الفهرس (index) المُحدَّد من المصفوفة.
+
* الدالة <code>[[Kotlin/Array/get|Array.get()‎]]</code>: تعيد العنصر من المصفوفة عند الفهرس (index) المُحدَّد.
  
 
== مصادر ==
 
== مصادر ==
* التابع 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) المُحدَّد.

مصادر