Set Values¶

Description¶

This operation updates a value for a key if it exists. In case the specified key does not exist, then a new key-value pair is added.

Method¶

Backendless.Hive(hiveName).MapStore(keyName).set(values);

where:

Argument	Description
`hiveName`	Name of a hive where the operation is performed. String value.
`keyName`	Key name identifying a map. String value.
`values`	Key-value pairs that must be added to the map. Keys must be of the string type, and values of any data type.

Return Value¶

The number of newly added key-value pairs.

Example¶

The example below adds new key-value pairs "Pineapples":1.99 and "Grapes":1.49 to the "fruits" map.

Map<String, Object> values = new HashMap<>();
values.put("Pineapples", 1.99);
values.put("Grapes", 1.49);

Backendless.Hive("groceryStore").MapStore("fruits").set(values);

where:

Argument	Description
`"groceryStore"`	Name of a hive where the operation is performed.
`"fruits"`	Key name identifying a map.

Codeless Reference¶

map_api_set_values

where:

Argument	Description
`hive name`	Name of a hive where the operation is performed.
`key name`	Key name identifying a map.
`values(object)`	An object containing key-value pairs that must be added to the map.

Returns the number of newly added key-value pairs.

Consider the following Map storage:
map_apI_example_map_store

The example below adds new key-value pairs "Pineapples":1.99 and "Grapes":1.49 to the "fruits" map.

map_api_example_set_values

The map will look as shown below after the Codeless logic runs:
map_apI_example_map_store_4