# replacing(_:maxReplacements:with:) Returns a new collection in which all occurrences of a sequence matching the given regex are replaced by another collection. ``` func replacing(_ regex: some RegexComponent, maxReplacements: Int = .max, with replacement: (Regex

.Match) throws -> Replacement) rethrows -> Self where Replacement : Collection, Replacement.Element == Character ``` ## Parameters `regex` A regex describing the sequence to replace. `maxReplacements` A number specifying how many occurrences of the sequence matching `regex` to replace. Default is `Int.max`. `replacement` A closure that receives the full match information, including captures, and returns a replacement collection. ## Return Value A new collection in which all occurrences of subsequence matching `regex` are replaced by `replacement`. --- 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)