56 lines
1.2 KiB
Markdown
56 lines
1.2 KiB
Markdown
---
|
|
title: strings.replace() function
|
|
description: >
|
|
The strings.replace() function replaces the first `i` non-overlapping instances
|
|
of a substring with a specified replacement.
|
|
aliases:
|
|
- /influxdb/v2.0/reference/flux/functions/strings/replace/
|
|
- /influxdb/v2.0/reference/flux/stdlib/strings/replace/
|
|
- /influxdb/cloud/reference/flux/stdlib/strings/replace/
|
|
menu:
|
|
flux_0_x_ref:
|
|
name: strings.replace
|
|
parent: strings
|
|
weight: 301
|
|
related:
|
|
- /flux/v0.x/stdlib/strings/replaceall
|
|
introduced: 0.18.0
|
|
---
|
|
|
|
The `strings.replace()` function replaces the first `i` non-overlapping instances
|
|
of a substring with a specified replacement.
|
|
|
|
_**Output data type:** String_
|
|
|
|
```js
|
|
import "strings"
|
|
|
|
strings.replace(v: "oink oink oink", t: "oink", u: "moo", i: 2)
|
|
|
|
// returns "moo moo oink"
|
|
```
|
|
|
|
## Parameters
|
|
|
|
### v
|
|
The string value to search.
|
|
|
|
### t {data-type="string"}
|
|
The substring value to replace.
|
|
|
|
### u {data-type="string"}
|
|
The replacement for `i` instances of `t`.
|
|
|
|
### i {data-type="int"}
|
|
The number of non-overlapping `t` matches to replace.
|
|
|
|
## Examples
|
|
|
|
###### Replace a specific number of string matches
|
|
```js
|
|
import "strings"
|
|
|
|
data
|
|
|> map(fn: (r) => ({r with content: strings.replace(v: r.content, t: "he", u: "her", i: 3)}))
|
|
```
|