49 lines
1.1 KiB
Markdown
49 lines
1.1 KiB
Markdown
---
|
|
title: strings.substring() function
|
|
description: >
|
|
The strings.substring() function returns a substring based on `start` and `end` parameters.
|
|
Indices are based on UTF code points.
|
|
aliases:
|
|
- /influxdb/v2.0/reference/flux/functions/strings/substring/
|
|
- /influxdb/v2.0/reference/flux/stdlib/strings/substring/
|
|
- /influxdb/cloud/reference/flux/stdlib/strings/substring/
|
|
menu:
|
|
flux_0_x_ref:
|
|
name: strings.substring
|
|
parent: strings
|
|
weight: 301
|
|
introduced: 0.35.0
|
|
---
|
|
|
|
The `strings.substring()` function returns a substring based on `start` and `end` parameters.
|
|
These parameters are represent indices of UTF code points in the string.
|
|
|
|
_**Output data type:** String_
|
|
|
|
```js
|
|
import "strings"
|
|
|
|
strings.substring(v: "influx", start: 0, end: 4)
|
|
|
|
// returns "infl"
|
|
```
|
|
|
|
## Parameters
|
|
|
|
### v {data-type="string"}
|
|
The string value to search.
|
|
|
|
### start {data-type="int"}
|
|
The starting inclusive index of the substring.
|
|
|
|
### end {data-type="int"}
|
|
The ending exclusive index of the substring.
|
|
|
|
## Examples
|
|
|
|
###### Store the first four characters of a string
|
|
```js
|
|
data
|
|
|> map(fn: (r) => ({r with abbr: strings.substring(v: r.name, start: 0, end: 4)}))
|
|
```
|