---
title: strings.replace() function
description: strings.replace() replaces the first i non-overlapping instances of a substring with a specified replacement.
url: https://docs.influxdata.com/flux/v0/stdlib/strings/replace/
estimated_tokens: 1501
product: Flux
version: v0
---

# strings.replace() function

-   Flux 0.18.0+
-   View InfluxDB support

`strings.replace()` replaces the first `i` non-overlapping instances of a substring with a specified replacement.

##### Function type signature

```js
(i: int, t: string, u: string, v: string) => string
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### v

(Required) String value to search.

### t

(Required) Substring value to replace.

### u

(Required) Replacement for `i` instances of `t`.

### i

(Required) Number of non-overlapping `t` matches to replace.

## Examples

### Replace a specific number of string matches

```js
import "sampledata"
import "strings"

sampledata.string()
    |> map(fn: (r) => ({r with _value: strings.replace(v: r._value, t: "p", u: "XX", i: 2)}))
```

[](#view-example-input-and-output)

View example input and output

#### Input data

| _time | *tag | _value |
| --- | --- | --- |
| 2021-01-01T00:00:00Z | t1 | smpl_g9qczs |
| 2021-01-01T00:00:10Z | t1 | smpl_0mgv9n |
| 2021-01-01T00:00:20Z | t1 | smpl_phw664 |
| 2021-01-01T00:00:30Z | t1 | smpl_guvzy4 |
| 2021-01-01T00:00:40Z | t1 | smpl_5v3cce |
| 2021-01-01T00:00:50Z | t1 | smpl_s9fmgy |

| _time | *tag | _value |
| --- | --- | --- |
| 2021-01-01T00:00:00Z | t2 | smpl_b5eida |
| 2021-01-01T00:00:10Z | t2 | smpl_eu4oxp |
| 2021-01-01T00:00:20Z | t2 | smpl_5g7tz4 |
| 2021-01-01T00:00:30Z | t2 | smpl_sox1ut |
| 2021-01-01T00:00:40Z | t2 | smpl_wfm757 |
| 2021-01-01T00:00:50Z | t2 | smpl_dtn2bv |

#### Output data

| _time | _value | *tag |
| --- | --- | --- |
| 2021-01-01T00:00:00Z | smXXl_g9qczs | t1 |
| 2021-01-01T00:00:10Z | smXXl_0mgv9n | t1 |
| 2021-01-01T00:00:20Z | smXXl_XXhw664 | t1 |
| 2021-01-01T00:00:30Z | smXXl_guvzy4 | t1 |
| 2021-01-01T00:00:40Z | smXXl_5v3cce | t1 |
| 2021-01-01T00:00:50Z | smXXl_s9fmgy | t1 |

| _time | _value | *tag |
| --- | --- | --- |
| 2021-01-01T00:00:00Z | smXXl_b5eida | t2 |
| 2021-01-01T00:00:10Z | smXXl_eu4oxXX | t2 |
| 2021-01-01T00:00:20Z | smXXl_5g7tz4 | t2 |
| 2021-01-01T00:00:30Z | smXXl_sox1ut | t2 |
| 2021-01-01T00:00:40Z | smXXl_wfm757 | t2 |
| 2021-01-01T00:00:50Z | smXXl_dtn2bv | t2 |

#### Related

-   [strings.replaceAll() function](/flux/v0/stdlib/strings/replaceall/)