The element to append to the array. 配列に追加されることになる要素。
append(_:)
Availability
- iOS 8.0+
- iPadOS 8.0+
- macOS 10.10+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
- Xcode 10.2+
Technology
- Swift Standard Library Swift標準ライブラリ
Declaration 宣言
mutating func append(_ newElement: Element)
Parameters パラメータ
newElement
Discussion 解説
Use this method to append a single element to the end of a mutable array. このメソッドを使ってある単一の要素を可変の配列の終わりに加えてください。
Because arrays increase their allocated capacity using an exponential strategy, appending a single element to an array is an O(1) operation when averaged over many calls to the append(_:)
method. When an array has additional capacity and is not sharing its storage with another instance, appending an element is O(1). When an array needs to reallocate storage before appending or its storage is shared with another copy, appending is O(n), where n is the length of the array.
配列はそれらの割り当てられた容量を指数戦略で増やすので、ある単一の要素を配列に加えることは、append(_:)
メソッドへの多くの呼び出しにわたって平均した場合は、O(1)演算です。配列がさらなる容量を持っていてそれのストレージを別のインスタンスと共有していない場合、ある要素を追加することはO(1)です。配列が追加の前にストレージの際割り当てを必要とするかそれのストレージを別のコピーと共有する場合、追加作業はO(n)です、そこでnは配列の長さです。
Complexity: O(1) on average, over many calls to append(_:)
on the same array.
計算量:同じ配列上でのappend(_:)
への多くの呼び出しに対して、均してO(1)。
Relationships 関係
From Protocol 由来プロトコル
See Also 参照
Adding Elements 要素の追加
func insert(Element, at: Int)
func insert<C>(contentsOf : C, at: Int)
func replaceSubrange <C>(Range<Int>, with: C)
func replaceSubrange <C, R>(R, with: C)
func reserveCapacity (Int)