docs-v2/content/flux/v0/stdlib/regexp/matchregexpstring.md

title	description	menu	weight
regexp.matchRegexpString() function	`regexp.matchRegexpString()` tests if a string contains any match to a regular expression.	flux_v0_ref name parent identifier regexp.matchRegexpString regexp regexp/matchRegexpString	101

regexp.matchRegexpString() tests if a string contains any match to a regular expression.

Function type signature

(r: regexp, v: string) => bool

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

Parameters

r

({{< req >}}) Regular expression used to search v.

v

({{< req >}}) String value to search.

Examples

• Test if a string contains a regular expression match
• Filter by rows that contain matches to a regular expression

Test if a string contains a regular expression match

import "regexp"

regexp.matchRegexpString(r: /(gopher){2}/, v: "gophergophergopher")// Returns true

Filter by rows that contain matches to a regular expression

import "regexp"
import "sampledata"

sampledata.string()
    |> filter(fn: (r) => regexp.matchRegexpString(r: /_\d/, v: r._value))