# ee.String.match

Matches a string against a regular expression. Returns a list of matching strings.

<br />

| Usage | Returns |
|---|---|
| `String.match(regex, *flags*)` | List |

| Argument | Type | Details |
|---|---|---|
| this: `input` | String | The string in which to search. |
| `regex` | String | The regular expression to match. |
| `flags` | String, default: "" | A string specifying a combination of regular expression flags, specifically one or more of: 'g' (global match) or 'i' (ignore case). |

## Examples

### Code Editor (JavaScript)

```javascript
var s = ee.String('ABCabc123');
print(s.match(''));  // ""
print(s.match('ab', 'g'));  // ab
print(s.match('ab', 'i'));  // AB
print(s.match('AB', 'ig'));  // ["AB","ab"]
print(s.match('[a-z]+[0-9]+'));  // "abc123"
print(s.match('\\d{2}'));  // "12"

// Use [^] to match any character except a digit.
print(s.match('abc[^0-9]', 'i'));  // ["ABCa"]
```
Python setup

See the [Python Environment](https://developers.google.com/earth-engine/guides/python_install) page for information on the Python API and using
`geemap` for interactive development.

```python
import ee
import geemap.core as geemap
```

### Colab (Python)

```python
s = ee.String('ABCabc123')
display(s.match(''))  # ""
display(s.match('ab', 'g'))  # ab
display(s.match('ab', 'i'))  # AB
display(s.match('AB', 'ig'))  # ['AB','ab']
display(s.match('[a-z]+[0-9]+'))  # 'abc123'
display(s.match('\\d{2}'))  # '12'

# Use [^] to match any character except a digit.
display(s.match('abc[^0-9]', 'i'))  # ['ABCa']
```