Instance Method

remove(at:)

Removes and returns the character at the specified position.

Declaration

@discardableResult mutating func remove(at i: String.Index) -> Character

Parameters

i

The position of the character to remove. i must be a valid index of the string that is not equal to the string’s end index.

Return Value

The character that was removed.

Discussion

All the elements following i are moved to close the gap. This example removes the hyphen from the middle of a string.

var nonempty = "non-empty"
if let i = nonempty.firstIndex(of: "-") {
    nonempty.remove(at: i)
}
print(nonempty)
// Prints "nonempty"

Calling this method invalidates any existing indices for use with this string.

Relationships

See Also

Removing Substrings

func remove(at: Index) -> Character

Removes and returns the element at the specified position.

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.

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.

func removeSubrange(Range<Index>)

Removes the elements in the specified subrange from the collection.

Beta
func removeSubrange<R>(R)

Removes the elements in the specified subrange from the collection.

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(Int) -> Substring

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

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.