Instance Method インスタンスメソッド

append(_:)

Adds a new element at the end of the array. 新しい要素を配列の終わりに加えます。

Declaration 宣言

mutating func append(_ newElement: Element)

Parameters パラメータ

newElement

The element to append to the array. 配列に追加されることになる要素。

Discussion 解説

Use this method to append a single element to the end of a mutable array. このメソッドを使ってある単一の要素を可変の配列の終わりに加えてください。


var numbers = [1, 2, 3, 4, 5]
numbers.append(100)
print(numbers)
// Prints "[1, 2, 3, 4, 5, 100]"

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 要素の追加