---
title: "replacing(_:maxReplacements:with:)"
framework: swift
role: symbol
role_heading: Instance Method
path: "swift/rangereplaceablecollection/replacing(_:maxreplacements:with:)"
---

# replacing(_:maxReplacements:with:)

Returns a new collection in which all occurrences of a sequence matching the given regex are replaced by another collection.

## Declaration

```swift
func replacing<Output, Replacement>(_ regex: some RegexComponent, maxReplacements: Int = .max, with replacement: (Regex<Output>.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

Return Value A new collection in which all occurrences of subsequence matching regex are replaced by replacement.