Instance Method

dropFirst(_:)

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

Declaration

func dropFirst(_ k: Int = 1) -> Slice<Dictionary<Key, Value>>

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 Elements

func drop(while: ((key: Key, value: Value)) -> Bool) -> Slice<Dictionary<Key, Value>>

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

func dropLast(Int) -> Slice<Dictionary<Key, Value>>

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

func popFirst() -> Dictionary<Key, Value>.Element?

Removes and returns the first key-value pair of the dictionary if the dictionary isn’t empty.