---
title: strings.splitN() function
description: >
  The strings.splitN() function splits a string on a specified separator and returns
  an array of `i` substrings.
aliases:
  - /influxdb/cloud/reference/flux/functions/strings/splitn/
menu:
  influxdb_cloud_ref:
    name: strings.splitN
    parent: Strings
weight: 301
related:
  - /influxdb/cloud/reference/flux/stdlib/strings/split
  - /influxdb/cloud/reference/flux/stdlib/strings/splitafter
  - /influxdb/cloud/reference/flux/stdlib/strings/splitaftern
---

The `strings.splitN()` function splits a string on a specified separator and returns
an array of `i` substrings.

_**Output data type:** Array of strings_

```js
import "strings"

strings.splitN(v: "a flux of foxes", t: " ", i: 3)

// returns ["a", "flux", "of foxes"]
```

## Parameters

### v
The string value to split.

_**Data type:** String_

### t
The string value that acts as the separator.

_**Data type:** String_

### i
The maximum number of split substrings to return.
`-1` returns all matching substrings.
The last substring is the unsplit remainder.

_**Data type:** Integer_

## Examples

###### Split a string into an array of substrings
```js
import "strings"

data
  |> map (fn:(r) => strings.splitN(v: r.searchTags, t: ","))
```