docs-v2/content/flux/v0.x/stdlib/strings/replace.md

title	description	aliases	menu	weight	related	introduced
strings.replace() function	The strings.replace() function replaces the first `i` non-overlapping instances of a substring with a specified replacement.	/influxdb/v2.0/reference/flux/functions/strings/replace/ /influxdb/v2.0/reference/flux/stdlib/strings/replace/ /influxdb/cloud/reference/flux/stdlib/strings/replace/	flux_0_x_ref name parent strings.replace strings	301	/flux/v0.x/stdlib/strings/replaceall	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

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

The substring value to replace.

u

The replacement for i instances of t.

i

The number of non-overlapping t matches to replace.

Examples

Replace a specific number of string matches

import "strings"

data
    |> map(fn: (r) => ({r with content: strings.replace(v: r.content, t: "he", u: "her", i: 3)}))