Adds an element to the end of the collection.
Required. Default implementation provided.
SDK
- Xcode 10.0+
Framework
- Swift Standard Library
Declaration
mutating func append(_ newElement: Self.Element)
Parameters
newElementThe element to append to the collection.
Discussion
If the collection does not have sufficient capacity for another element, additional storage is allocated before appending new. The following example adds a new number to an array of integers:
var numbers = [1, 2, 3, 4, 5]
numbers.append(100)
print(numbers)
// Prints "[1, 2, 3, 4, 5, 100]"
Complexity: O(1) on average, over many calls to append(_:) on the same collection.