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

مراجعة 17:02، 6 أغسطس 2018

تضيف الدالة plusElement()‎ العنصر المُمرّر إليها إلى المصفوفة أو المجموعة التي استُدعيت معها.

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

إن استدعيت الدالة plusElement()‎ مع المصفوفات، فستعيد مصفوفة تضم جميع عناصر المصفوفة التي استدعيت معها إضافةً إلى العنصر المُمرّر إليها:

inline fun <T> Array<T>.plusElement(element: T): Array<T>

وإن استدعيت مع المجموعات، فستعيد قائمة تضم جميع عناصر المجموعة التي استدعيت معها إضافةً إليها العنصر المُمرّر إليها:

inline fun <T> Iterable<T>.plusElement(element: T): List<T> 
inline fun <T> Collection<T>.plusElement(element: T): List<T>

أمَّا إن استدعيت مع مجموعة من النوع Set، فستعيد مجموعة من ذات النوع تضم جميع عناصر المجموعة التي استدعيت معها إضافةً إلى العنصر المُمرّر إليها إن لم يكن موجودًا مسبقًا؛ تحافظ المجموعة المعادة على ترتيب التكرار للمجموعة الأصلية:

inline fun <T> Set<T>.plusElement(element: T): Set<T>

وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).

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

تُعاد مصفوفة أو مجموعة تحتوي على جميع عناصر المصفوفة أو المجموعة المعطاة مضافًا إليها العنصر element المعطى.

أمثلة

استخدام الدالة `()plusElement` مع اللوائح

استعمال الدالة ()plusElement لإضافة عنصر جديد إلى قائمة:

fun main(args: Array<String>) {
    val iterable = listOf(1, 2, 3, 4, 5)

    println(iterable.plusElement(15)) // [1, 2, 3, 4, 5, 15]
}

انظر أيضًا

الدالة plus()‎: تضيف الوسيط المُمرَّر إليها إلى الكائن الذي استدعيت معه.
الدالة fill()‎: تبدِّل قيمة جديدة معطاة مكان عناصر محدَّدة في المصفوفة أو القائمة التي تستدعى معها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>plusElement()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>plusElement()‎</code> في Kotlin}}</noinclude>
-تضيف  الدالة <code>plusElement()‎</code> العنصر المُمرّر إلى [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها.
+تضيف الدالة <code>plusElement()‎</code> العنصر المُمرّر إليها إلى [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها.
 ==البنية العامة==
-في حال استدعاء الدالة <code>plusElement()‎</code> عبر  [[Kotlin/Array|المصفوفات]] فستعيد [[Kotlin/Array|مصفوفة]] تضم جميع عناصر المصفوفة التي استدعيت عبرها إضافة إلى العنصر المُمرّر:<syntaxhighlight lang="kotlin">
+إن استدعيت الدالة <code>plusElement()‎</code> مع [[Kotlin/Array|المصفوفات]]، فستعيد [[Kotlin/Array|مصفوفة]] تضم جميع عناصر المصفوفة التي استدعيت معها إضافةً إلى العنصر المُمرّر إليها:<syntaxhighlight lang="kotlin">
 inline fun <T> Array<T>.plusElement(element: T): Array<T>
-</syntaxhighlight>
+</syntaxhighlight>وإن استدعيت مع [[Kotlin/collections|المجموعات]]، فستعيد [[Kotlin/List|قائمة]] تضم جميع عناصر [[Kotlin/collections|المجموعة]] التي استدعيت معها إضافةً إليها العنصر المُمرّر إليها:<syntaxhighlight lang="kotlin">
-في حال استدعاء الدالة <code>plusElement()‎</code> عبر  [[Kotlin/collections|المجموعات]] فستعيد [[Kotlin/List|لائحة]] تضم جميع عناصر [[Kotlin/collections|المجموعة]] <nowiki/>التي استدعيت عبرها إضافة إلى العنصر المُمرّر: <syntaxhighlight lang="kotlin">
 inline fun <T> Iterable<T>.plusElement(element: T): List<T>
 inline fun <T> Collection<T>.plusElement(element: T): List<T>
-</syntaxhighlight><nowiki/>في حال استدعاء الدالة <code>plusElement()‎</code> عبر  [[Kotlin/Set|مجموعة]] من النوع <code>Set</code> ، فستعيد [[Kotlin/Set|مجموعة]] من النوع <code>Set</code> تضم جميع عناصر [[Kotlin/collections|المجموعة]] التي استدعيت عبرها إضافة إلى العنصر المُمرّر إن لم يكن موجودًا سلفًا، المجموعة المعادة تحافظ على ترتيب التكرار [[Kotlin/Set|للمجموعة]] الأصلية:<nowiki/><syntaxhighlight lang="kotlin">
+</syntaxhighlight>أمَّا إن استدعيت مع مجموعة من النوع <code>[[Kotlin/Set|Set]]</code>، فستعيد [[Kotlin/Set|مجموعة]] من ذات النوع تضم جميع عناصر [[Kotlin/collections|المجموعة]] التي استدعيت معها إضافةً إلى العنصر المُمرّر إليها إن لم يكن موجودًا مسبقًا؛ تحافظ المجموعة المعادة على ترتيب التكرار [[Kotlin/Set|للمجموعة]] الأصلية:<syntaxhighlight lang="kotlin">
 inline fun <T> Set<T>.plusElement(element: T): Set<T>
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
-==القيم المٌعادة==
+==القيم المعادة==
-على حسب إمضاء الدالة (انظر فقرة [[Kotlin/collections/plusElement#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]).
+تُعاد مصفوفة أو مجموعة تحتوي على جميع عناصر المصفوفة أو المجموعة المعطاة مضافًا إليها العنصر <code>element</code> المعطى.
 ==أمثلة==
 ===استخدام الدالة <code>()plusElement</code> مع اللوائح===
-تعرف الشيفرة الآتية <nowiki/>[[Kotlin/List|لائحة]]<nowiki/><nowiki/> باسم <code>iterable</code>مكونة من خمسة أعداد باستخدام الدالة <code>()listOf</code>، ثم تستدعي الدالة <code>()plusElement</code> عبر <code>iterable</code>   لإضافة العدد <code>15</code> إليها<nowiki/>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+استعمال الدالة <code>()plusElement</code> لإضافة عنصر جديد إلى قائمة:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
      val iterable = listOf(1, 2, 3, 4, 5)
@@ سطر 26: / سطر 23: @@
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/collections/plus|plus()]]</code>‎: تضيف عنصرًا واحدًا أو عدة عناصر إلى الكائن الذي استُدعيت عبره.
+*الدالة <code>[[Kotlin/collections/plus|plus()]]</code>‎: تضيف الوسيط المُمرَّر إليها إلى الكائن الذي استدعيت معه.
+* الدالة <code>[[Kotlin/collections/fill|fill()‎]]</code>: تبدِّل قيمة جديدة معطاة مكان عناصر محدَّدة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي تستدعى معها.
 ==مصادر==
-*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/plus-element.html الدالة  plusElement()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/plus-element.html صفحة الدالة plusElement()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]