---
title: "insert(contentsOf:at:)"
framework: swift
role: symbol
role_heading: Instance Method
path: "swift/string/insert(contentsof:at:)"
---

# insert(contentsOf:at:)

Inserts a collection of characters at the specified position.

## Declaration

```swift
mutating func insert<S>(contentsOf newElements: S, at i: String.Index) where S : Collection, S.Element == Character
```

## Parameters

- `newElements`: A collection of Character elements to insert into the string.
- `i`: A valid index of the string. If i is equal to the string’s end index, this methods appends the contents of newElements to the string.

## Discussion

Discussion Calling this method invalidates any existing indices for use with this string. note: O(n), where n is the combined length of the string and newElements.

## See Also

### Inserting Characters

- [insert(_:at:)](swift/string/insert(_:at:).md)
- [insert(_:at:)](swift/string/insert(_:at:)-88yqh.md)
- [insert(contentsOf:at:)](swift/string/insert(contentsof:at:)-rdu9.md)