Back to Influxdb

string() function

content/flux/v0/stdlib/universe/string.md

latest3.3 KB
Original Source
<!------------------------------------------------------------------------------ IMPORTANT: This page was generated from comments in the Flux source code. Any edits made directly to this page will be overwritten the next time the documentation is generated. To make updates to this documentation, update the function comments above the function definition in the Flux source code: https://github.com/influxdata/flux/blob/master/stdlib/universe/universe.flux#L3351-L3351 Contributing to Flux: https://github.com/influxdata/flux#contributing Fluxdoc syntax: https://github.com/influxdata/flux/blob/master/docs/fluxdoc.md ------------------------------------------------------------------------------->

string() converts a value to a string type.

Function type signature
js
(v: A) => string

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

Parameters

v

({{< req >}}) Value to convert.

Examples

Convert basic types to strings

js
string(v: true)
// Returns "true"

string(v: 1m)
// Returns "1m"

string(v: 2021-01-01T00:00:00Z)
// Returns "2021-01-01T00:00:00Z"

string(v: 10.12)
// Returns "10.12"

Convert all values in a column to strings

If converting the _value column to string types, use toString(). If converting columns other than _value, use map() to iterate over each row and string() to convert a column value to a string type.

js
data
    |> map(fn: (r) => ({r with exampleCol: string(v: r.exampleCol)}))

{{< expand-wrapper >}} {{% expand "View example input and output" %}}

Input data

_time*tagexampleCol
2021-01-01T00:00:00Zt1-2.18
2021-01-01T00:00:10Zt110.92
2021-01-01T00:00:20Zt17.35
2021-01-01T00:00:30Zt117.53
2021-01-01T00:00:40Zt115.23
2021-01-01T00:00:50Zt14.43
_time*tagexampleCol
2021-01-01T00:00:00Zt219.85
2021-01-01T00:00:10Zt24.97
2021-01-01T00:00:20Zt2-3.75
2021-01-01T00:00:30Zt219.77
2021-01-01T00:00:40Zt213.86
2021-01-01T00:00:50Zt21.86

Output data

_timeexampleCol*tag
2021-01-01T00:00:00Z-2.18t1
2021-01-01T00:00:10Z10.92t1
2021-01-01T00:00:20Z7.35t1
2021-01-01T00:00:30Z17.53t1
2021-01-01T00:00:40Z15.23t1
2021-01-01T00:00:50Z4.43t1
_timeexampleCol*tag
2021-01-01T00:00:00Z19.85t2
2021-01-01T00:00:10Z4.97t2
2021-01-01T00:00:20Z-3.75t2
2021-01-01T00:00:30Z19.77t2
2021-01-01T00:00:40Z13.86t2
2021-01-01T00:00:50Z1.86t2

{{% /expand %}} {{< /expand-wrapper >}}