Documentation

dict.insert() function

Flux 0.97.0+

The dict.insert() function inserts a key value pair into a dictionary and returns a new, updated dictionary. If the key already exists in the dictionary, the function overwrites the existing value.

import "dict"

dict.insert(
  dict: [1: "foo", 2: "bar"],
  key: 3,
  value: "baz"
)

Parameters

All paremeters are required

dict

Dictionary to update.

key

Key to insert into the dictionary. Must be the same type as existing keys in the dictionary.

default

Value to insert into the dictionary. Must be the same type as existing values in the dictionary.

Examples

Insert a new key-value pair into a dictionary
import "dict"

d = [1: "foo", 2: "bar"]

dNew = dict.insert(
  dict: d,
  key: 3,
  value: "baz"
)

// Verify the new key-value pair was inserted
dict.get(dict: dNew, key: 3, default: "")

// Returns baz
Overwrite an existing key-value pair in a dictionary
import "dict"

d = [1: "foo", 2: "bar"]

dNew = dict.insert(
  dict: d,
  key: 2,
  value: "baz"
)

// Verify the new key-value pair was overwritten
dict.get(dict: dNew, key: 2, default: "")

// Returns baz

Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.