Instance Method

dropFirst(_:)

Returns a subsequence containing all but the given number of initial elements.

Declaration

func dropFirst(_ k: Int = 1) -> Data

Parameters

k

The number of elements to drop from the beginning of the collection. k must be greater than or equal to zero.

Return Value

A subsequence starting after the specified number of elements.

Discussion

If the number of elements to drop exceeds the number of elements in the collection, the result is an empty subsequence.

let numbers = [1, 2, 3, 4, 5]
print(numbers.dropFirst(2))
// Prints "[3, 4, 5]"
print(numbers.dropFirst(10))
// Prints "[]"

Complexity: O(1) if the collection conforms to RandomAccessCollection; otherwise, O(k), where k is the number of elements to drop from the beginning of the collection.

See Also

Excluding Bytes

func dropLast(Int) -> Data

Returns a subsequence containing all but the specified number of final elements.

func drop(while: (UInt8) -> Bool) -> Data

Returns a subsequence by skipping elements while predicate returns true and returning the remaining elements.

func advanced(by: Int) -> Data

Returns a new data buffer created by removing the given number of bytes from the front of the original buffer.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software