الفرق بين المراجعتين ل"Kotlin/collections/plusElement"
< Kotlin | collections
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط |
|||
| (3 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: الدالة <code>plusElement()</code> في | + | <noinclude>{{DISPLAYTITLE: الدالة <code>plusElement()</code> في Kotlin}}</noinclude> |
| − | تضيف | + | تضيف الدالة <code>plusElement()</code> العنصر المُمرّر إليها إلى [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت معها. |
| − | |||
==البنية العامة== | ==البنية العامة== | ||
| − | + | إن استدعيت الدالة <code>plusElement()</code> مع [[Kotlin/Array|المصفوفات]]، فستعيد [[Kotlin/Array|مصفوفة]] تضم جميع عناصر المصفوفة التي استدعيت معها إضافةً إلى العنصر المُمرّر إليها:<syntaxhighlight lang="kotlin"> | |
inline fun <T> Array<T>.plusElement(element: T): Array<T> | inline fun <T> Array<T>.plusElement(element: T): Array<T> | ||
| − | </syntaxhighlight> | + | </syntaxhighlight>وإن استدعيت مع [[Kotlin/collections|المجموعات]]، فستعيد [[Kotlin/List|قائمة]] تضم جميع عناصر [[Kotlin/collections|المجموعة]] التي استدعيت معها إضافةً إليها العنصر المُمرّر إليها:<syntaxhighlight lang="kotlin"> |
| − | |||
| − | |||
inline fun <T> Iterable<T>.plusElement(element: T): List<T> | inline fun <T> Iterable<T>.plusElement(element: T): List<T> | ||
inline fun <T> Collection<T>.plusElement(element: T): List<T> | inline fun <T> Collection<T>.plusElement(element: T): List<T> | ||
| − | </syntaxhighlight> | + | </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> | inline fun <T> Set<T>.plusElement(element: T): Set<T> | ||
| − | </syntaxhighlight> | + | </syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). |
| − | == | + | |
| − | + | == المعاملات == | |
| + | |||
| + | === <code>element</code> === | ||
| + | العنصر المراد إضافته إلى [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] المعطاة. | ||
| + | |||
| + | ==القيم المعادة== | ||
| + | تُعاد مصفوفة أو مجموعة تحتوي على جميع عناصر المصفوفة أو المجموعة المعطاة مضافًا إليها العنصر <code>element</code> المعطى. | ||
==أمثلة== | ==أمثلة== | ||
| − | + | استعمال الدالة <code>()plusElement</code> لإضافة عنصر جديد إلى قائمة:<syntaxhighlight lang="kotlin"> | |
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val iterable = listOf(1, 2, 3, 4, 5) | val iterable = listOf(1, 2, 3, 4, 5) | ||
| سطر 25: | سطر 27: | ||
} | } | ||
</syntaxhighlight> | </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 الدالة | + | *[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/plus-element.html صفحة الدالة plusElement() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
| − | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
| + | [[تصنيف:Kotlin Collection]] | ||
المراجعة الحالية بتاريخ 09:57، 8 سبتمبر 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
العنصر المراد إضافته إلى المصفوفة أو المجموعة المعطاة.
القيم المعادة
تُعاد مصفوفة أو مجموعة تحتوي على جميع عناصر المصفوفة أو المجموعة المعطاة مضافًا إليها العنصر element المعطى.
أمثلة
استعمال الدالة ()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(): تبدِّل قيمة جديدة معطاة مكان عناصر محدَّدة في المصفوفة أو القائمة التي تستدعى معها.