Generic Instance Method

removeSubrange(_:)

Removes the elements in the specified subrange from the collection.

Declaration

mutating func removeSubrange<R>(_ bounds: R) where R : RangeExpression, String.Index == R.Bound

Parameters

bounds

The range of the collection to be removed. The bounds of the range must be valid indices of the collection.

Discussion

All the elements following the specified position are moved to close the gap. This example removes three elements from the middle of an array of measurements.

var measurements = [1.2, 1.5, 2.9, 1.2, 1.5]
measurements.removeSubrange(1..<4)
print(measurements)
// Prints "[1.2, 1.5]"

Calling this method may invalidate any existing indices for use with this collection.

Complexity: O(n), where n is the length of the collection.

Relationships

Generic Constraints

  • R : RangeExpression
    
  • Self.Index == R.Bound
    

See Also

Removing Substrings

func remove(at: String.Index) -> Character

Removes and returns the character at the specified position.

Beta
func remove(at: String.Index) -> Character

Removes and returns the element at the specified position.

Beta
func removeAll(keepingCapacity: Bool)

Removes all elements from the collection.

Beta
func removeAll(keepingCapacity: Bool)

Replaces this string with the empty string.

func removeAll(where: (Character) -> Bool)

Removes all the elements that satisfy the given predicate.

Beta
func removeFirst() -> Character

Removes and returns the first element of the collection.

func removeFirst(Int)

Removes the specified number of elements from the beginning of the collection.

func removeLast() -> Character

Removes and returns the last element of the collection.

func removeLast(Int)

Removes the specified number of elements from the end of the collection.

func removeSubrange(Range<String.Index>)

Removes the characters in the given range.

Beta
func removeSubrange(Range<String.Index>)

Removes the elements in the specified subrange from the collection.

Beta
func filter((Character) -> Bool) -> String

Returns a new collection of the same type containing, in order, the elements of the original collection that satisfy the given predicate.

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

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

func dropFirst() -> Substring

Returns a subsequence containing all but the first element of the sequence.

func dropFirst(Int) -> Substring

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

func dropLast() -> Substring

Returns a subsequence containing all but the last element of the sequence.

func dropLast(Int) -> Substring

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

func popLast() -> Character?

Removes and returns the last element of the collection.

Beta