Instance Methodswift 6.0.1Swift
insert(_:at:)
Inserts a new element at the specified position.
mutating func insert(_ newElement: Element, at i: Int) Parameters
- newElement
The new element to insert into the array.
- i
The position at which to insert the new element.
indexmust be a valid index of the array or equal to itsendIndexproperty.
The new element is inserted before the element currently at the specified index. If you pass the array’s endIndex property as the index parameter, the new element is appended to the array.
var numbers = [1, 2, 3, 4, 5]
numbers.insert(100, at: 3)
numbers.insert(200, at: numbers.endIndex)
print(numbers)
// Prints "[1, 2, 3, 100, 4, 5, 200]"Other members in extension
Typealiases
typealias IndexThe index type for arrays,
Int.typealias IndicesThe type that represents the indices that are valid for subscripting an array, in ascending order.
typealias IteratorThe type that allows iteration over an array’s elements.
Type members
init() Creates a new, empty array.
init<S>(S) Creates an array containing the elements of a sequence.
init(arrayLiteral: Element...) Creates an array from the given array literal.
init(repeating: Element, count: Int) Creates a new array containing the specified number of a single, repeated value.
init(unsafeUninitializedCapacity: Int, initializingWith: (inout UnsafeMutableBufferPointer<Element>, inout Int) throws -> Void) rethrows Creates an array with the specified capacity, then calls the given closure with a buffer covering the array’s uninitialized memory.
static func + (lhs: Array<Element>, rhs: Array<Element>) -> Array<Element> static func += (lhs: inout Array<Element>, rhs: Array<Element>)
Instance members
var capacity: IntThe total number of elements that the array can contain without allocating new storage.
var count: IntThe number of elements in the array.
var customMirror: MirrorA mirror that reflects the array.
var debugDescription: StringA textual representation of the array and its elements, suitable for debugging.
var description: StringA textual representation of the array and its elements.
var endIndex: IntThe array’s “past the end” position—that is, the position one greater than the last valid subscript argument.
var startIndex: IntThe position of the first element in a nonempty array.
subscript(Range<Int>) -> ArraySlice<Element> Accesses a contiguous subrange of the array’s elements.
subscript(Int) -> Element Accesses the element at the specified position.
func append(Element) Adds a new element at the end of the array.
func append<S>(contentsOf: S) Adds the elements of a sequence to the end of the array.
func distance(from: Int, to: Int) -> Int Returns the distance between two indices.
func formIndex(after: inout Int) func formIndex(before: inout Int) func index(Int, offsetBy: Int) -> Int Returns an index that is the specified distance from the given index.
func index(Int, offsetBy: Int, limitedBy: Int) -> Int? Returns an index that is the specified distance from the given index, unless that distance is beyond a given limiting index.
func index(after: Int) -> Int Returns the position immediately after the given index.
func index(before: Int) -> Int Returns the position immediately before the given index.
func remove(at: Int) -> Element Removes and returns the element at the specified position.
func removeAll(keepingCapacity: Bool) Removes all elements from the array.
func replaceSubrange<C>(Range<Int>, with: C) Replaces a range of elements with the elements in the specified collection.
func reserveCapacity(Int) Reserves enough space to store the specified number of elements.
func withContiguousMutableStorageIfAvailable<R>((inout UnsafeMutableBufferPointer<Element>) throws -> R) rethrows -> R? func withContiguousStorageIfAvailable<R>((UnsafeBufferPointer<Element>) throws -> R) rethrows -> R? func withUnsafeBufferPointer<R>((UnsafeBufferPointer<Element>) throws -> R) rethrows -> R Calls a closure with a pointer to the array’s contiguous storage.
func withUnsafeBytes<R>((UnsafeRawBufferPointer) throws -> R) rethrows -> R Calls the given closure with a pointer to the underlying bytes of the array’s contiguous storage.
func withUnsafeMutableBufferPointer<R>((inout UnsafeMutableBufferPointer<Element>) throws -> R) rethrows -> R Calls the given closure with a pointer to the array’s mutable contiguous storage.
func withUnsafeMutableBytes<R>((UnsafeMutableRawBufferPointer) throws -> R) rethrows -> R Calls the given closure with a pointer to the underlying bytes of the array’s mutable contiguous storage.