الدالة plusElement() في لغة Kotlin
تضيف الدالة plusElement() العنصر المُمرّر إلى المصفوفة أو المجموعة التي استُدعيت عبرها.
البنية العامة
في حال استدعاء الدالة plusElement() عبر المصفوفات فستعيد مصفوفة تضم جميع عناصر المصفوفة التي استدعيت عبرها إضافة إلى العنصر المُمرّر:
inline fun <T> Array<T>.plusElement(element: T): Array<T>
في حال استدعاء الدالة plusElement() عبر المجموعات فستعيد لائحة تضم جميع عناصر المجموعة التي استدعيت عبرها إضافة إلى العنصر المُمرّر:
inline fun <T> Iterable<T>.plusElement(element: T): List<T>
inline fun <T> Collection<T>.plusElement(element: T): List<T>
في حال استدعاء الدالة plusElement() عبر مجموعة من النوع Set ، فستعيد مجموعة من النوع Set تضم جميع عناصر المجموعة التي استدعيت عبرها إضافة إلى العنصر المُمرّر إن لم يكن موجودًا سلفًا، المجموعة المعادة تحافظ على ترتيب التكرار للمجموعة الأصلية:
inline fun <T> Set<T>.plusElement(element: T): Set<T>
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المٌعادة
على حسب إمضاء الدالة (انظر فقرة البنية العامة).
أمثلة
استخدام الدالة ()plusElement مع اللوائح
تعرف الشيفرة الآتية لائحة باسم iterableمكونة من خمسة أعداد باستخدام الدالة ()listOf، ثم تستدعي الدالة ()plusElement عبر iterable لإضافة العدد 15 إليها، ثم تطبع الناتج:
fun main(args: Array<String>) {
val iterable = listOf(1, 2, 3, 4, 5)
println(iterable.plusElement(15)) // [1, 2, 3, 4, 5, 15]
}
انظر أيضًا
plus(): تضيف عنصرًا واحدًا أو عدة عناصر إلى الكائن الذي استُدعيت عبره.