---
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: 280
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/regexp/matchregexpstring/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.33.0+

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

```
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/)
