Instance Method

suffix(_:)

Returns a subsequence, up to the given maximum length, containing the final elements of the collection.

Declaration

func suffix(_ maxLength: Int) -> Substring

Parameters

maxLength

The maximum number of elements to return. maxLength must be greater than or equal to zero.

Return Value

A subsequence terminating at the end of the collection with at most maxLength elements.

Discussion

If the maximum length exceeds the number of elements in the collection, the result contains the entire collection.

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

Complexity: O(1) if the collection conforms to RandomAccessCollection; otherwise, O(k), where k is equal to maxLength.

See Also

Getting Substrings

subscript(Range<String.Index>) -> Substring

Accesses a contiguous subrange of the collection’s elements.

subscript<R>(R) -> Substring

Accesses the contiguous subrange of the collection’s elements specified by a range expression.

func prefix(Int) -> Substring

Returns a subsequence, up to the specified maximum length, containing the initial elements of the collection.

func prefix(through: Index) -> Substring

Returns a subsequence from the start of the collection through the specified position.

func prefix(upTo: Index) -> Substring

Returns a subsequence from the start of the collection up to, but not including, the specified position.

func prefix(while: (Character) -> Bool) -> Substring

Returns a subsequence containing the initial elements until predicate returns false and skipping the remaining elements.

func suffix(from: Index) -> Substring

Returns a subsequence from the specified position to the end of the collection.