# replace(_:with:maxReplacements:) Replaces all occurrences of the sequence matching the given regex with a given collection. ``` mutating func replace(_ regex: some RegexComponent, with replacement: Replacement, maxReplacements: Int = .max) where Replacement : Collection, Replacement.Element == Character ``` ## Parameters `regex` A regex describing the sequence to replace. `replacement` The new elements to add to the collection. `maxReplacements` A number specifying how many occurrences of the sequence matching `regex` to replace. Default is `Int.max`. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)