# replacing(_:with:subrange:maxReplacements:) 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, with replacement: Replacement, subrange: Range, maxReplacements: Int = .max) -> Self where Replacement : Collection, Replacement.Element == Character ``` ## Parameters `regex` A regex describing the sequence to replace. `replacement` The new elements to add to the collection. `subrange` The range in the collection in which to search for `regex`. `maxReplacements` A number specifying how many occurrences of the sequence matching `regex` to replace. Default is `Int.max`. ## Return Value A new collection in which all occurrences of subsequence matching `regex` in `subrange` 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)