---
title: strings.trim() function
description: strings.trim() removes leading and trailing characters specified in the cutset from a string.
url: https://docs.influxdata.com/flux/v0/stdlib/strings/trim/
estimated_tokens: 997
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/strings/trim/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.18.0+

InfluxDB support

`strings.trim()` removes leading and trailing characters specified in the cutset from a string.

##### Function type signature

```js
(cutset: string, v: string) => string
```

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

## Parameters

### v

(Required)
String to remove characters from.

### cutset

(Required)
Leading and trailing characters to remove from the string.

Only characters that match the cutset string exactly are trimmed.

## Examples

### Trim leading and trailing periods from all values in a column

```js
import "strings"

data
    |> map(fn: (r) => ({r with _value: strings.trim(v: r._value, cutset: "smpl_")}))
```

[](#view-example-input-and-output)

View example input and output

#### Input data

|       \_time       |   \_value    |\*tag|
|--------------------|--------------|-----|
|2021-01-01T00:00:00Z|.smpl\_g9qczs.| t1  |
|2021-01-01T00:00:10Z|.smpl\_0mgv9n.| t1  |
|2021-01-01T00:00:20Z|.smpl\_phw664.| t1  |
|2021-01-01T00:00:30Z|.smpl\_guvzy4.| t1  |
|2021-01-01T00:00:40Z|.smpl\_5v3cce.| t1  |
|2021-01-01T00:00:50Z|.smpl\_s9fmgy.| t1  |

|       \_time       |   \_value    |\*tag|
|--------------------|--------------|-----|
|2021-01-01T00:00:00Z|.smpl\_b5eida.| t2  |
|2021-01-01T00:00:10Z|.smpl\_eu4oxp.| t2  |
|2021-01-01T00:00:20Z|.smpl\_5g7tz4.| t2  |
|2021-01-01T00:00:30Z|.smpl\_sox1ut.| t2  |
|2021-01-01T00:00:40Z|.smpl\_wfm757.| t2  |
|2021-01-01T00:00:50Z|.smpl\_dtn2bv.| t2  |

#### Output data

|       \_time       |   \_value    |\*tag|
|--------------------|--------------|-----|
|2021-01-01T00:00:00Z|.smpl\_g9qczs.| t1  |
|2021-01-01T00:00:10Z|.smpl\_0mgv9n.| t1  |
|2021-01-01T00:00:20Z|.smpl\_phw664.| t1  |
|2021-01-01T00:00:30Z|.smpl\_guvzy4.| t1  |
|2021-01-01T00:00:40Z|.smpl\_5v3cce.| t1  |
|2021-01-01T00:00:50Z|.smpl\_s9fmgy.| t1  |

|       \_time       |   \_value    |\*tag|
|--------------------|--------------|-----|
|2021-01-01T00:00:00Z|.smpl\_b5eida.| t2  |
|2021-01-01T00:00:10Z|.smpl\_eu4oxp.| t2  |
|2021-01-01T00:00:20Z|.smpl\_5g7tz4.| t2  |
|2021-01-01T00:00:30Z|.smpl\_sox1ut.| t2  |
|2021-01-01T00:00:40Z|.smpl\_wfm757.| t2  |
|2021-01-01T00:00:50Z|.smpl\_dtn2bv.| t2  |

#### Related

* [strings.trimLeft() function](/flux/v0/stdlib/strings/trimleft/)
* [strings.trimRight() function](/flux/v0/stdlib/strings/trimright/)
* [strings.trimPrefix() function](/flux/v0/stdlib/strings/trimprefix/)
* [strings.trimSuffix() function](/flux/v0/stdlib/strings/trimsuffix/)
* [strings.trimSpace() function](/flux/v0/stdlib/strings/trimspace/)
| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z | .smpl_g9qczs. | t1 |
| 2021-01-01T00:00:10Z | .smpl_0mgv9n. | t1 |
| 2021-01-01T00:00:20Z | .smpl_phw664. | t1 |
| 2021-01-01T00:00:30Z | .smpl_guvzy4. | t1 |
| 2021-01-01T00:00:40Z | .smpl_5v3cce. | t1 |
| 2021-01-01T00:00:50Z | .smpl_s9fmgy. | t1 |

| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z | .smpl_b5eida. | t2 |
| 2021-01-01T00:00:10Z | .smpl_eu4oxp. | t2 |
| 2021-01-01T00:00:20Z | .smpl_5g7tz4. | t2 |
| 2021-01-01T00:00:30Z | .smpl_sox1ut. | t2 |
| 2021-01-01T00:00:40Z | .smpl_wfm757. | t2 |
| 2021-01-01T00:00:50Z | .smpl_dtn2bv. | t2 |

| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z | .smpl_g9qczs. | t1 |
| 2021-01-01T00:00:10Z | .smpl_0mgv9n. | t1 |
| 2021-01-01T00:00:20Z | .smpl_phw664. | t1 |
| 2021-01-01T00:00:30Z | .smpl_guvzy4. | t1 |
| 2021-01-01T00:00:40Z | .smpl_5v3cce. | t1 |
| 2021-01-01T00:00:50Z | .smpl_s9fmgy. | t1 |

| _time | _value | *tag |
| --- | --- | --- |
| _time | _value | *tag |
| 2021-01-01T00:00:00Z | .smpl_b5eida. | t2 |
| 2021-01-01T00:00:10Z | .smpl_eu4oxp. | t2 |
| 2021-01-01T00:00:20Z | .smpl_5g7tz4. | t2 |
| 2021-01-01T00:00:30Z | .smpl_sox1ut. | t2 |
| 2021-01-01T00:00:40Z | .smpl_wfm757. | t2 |
| 2021-01-01T00:00:50Z | .smpl_dtn2bv. | t2 |