# replacing(with:maxReplacements:content:) Returns a new collection in which all matches for the regex are replaced, using the given closure to create the regex. ``` func replacing(with replacement: Replacement, maxReplacements: Int = .max, @RegexComponentBuilder content: () -> some RegexComponent) -> Self where Replacement : Collection, Replacement.Element == Character ``` ## Parameters `replacement` The new elements to add to the collection in place of each match for the regex, using `content` to create the regex. `maxReplacements` A number specifying how many occurrences of regex to replace. `content` A closure that returns the collection to search for and replace. ## Return Value A new collection in which all matches for regex in `subrange` are replaced by `replacement`, using `content` to create the regex. --- 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)