---
title: regexp.matchRegexpString() function
description: regexp.matchRegexpString() tests if a string contains any match to a regular expression.
url: https://docs.influxdata.com/flux/v0/stdlib/regexp/matchregexpstring/
estimated_tokens: 975
product: Flux
version: v0
---

# regexp.matchRegexpString() function

-   Flux 0.33.0+
-   View InfluxDB support

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

##### Function type signature

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

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

## Parameters

### r

(Required) Regular expression used to search `v`.

### v

(Required) String value to search.

## Examples

-   [Test if a string contains a regular expression match](#test-if-a-string-contains-a-regular-expression-match)
-   [Filter by rows that contain matches to a regular expression](#filter-by-rows-that-contain-matches-to-a-regular-expression)

### Test if a string contains a regular expression match

```js
import "regexp"

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

```

### Filter by rows that contain matches to a regular expression

```js
import "regexp"
import "sampledata"

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

#### Related

-   [Work with regular expression types](/flux/v0/data-types/basic/regexp/)