# replacing(maxReplacements:content:with:) Returns a new collection in which all matches for the regex are replaced, using the given closures to create the replacement and the regex. ``` func replacing(maxReplacements: Int = .max, @RegexComponentBuilder content: () -> some RegexComponent, with replacement: (Regex

.Match) throws -> Replacement) rethrows -> Self where Replacement : Collection, Replacement.Element == Character ``` ## Parameters `maxReplacements` A number specifying how many occurrences of the regex to replace, using `content` to create the regex. `content` A closure that returns the collection to search for and replace. `replacement` A closure that receives the full match information, including captures, and returns a replacement collection. ## Return Value A new collection in which all matches for regex in `subrange` are replaced by the result of calling `replacement`, where regex is the result of calling `content`. --- 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)