Inserts a key and its associated value into a map. If the key is already included in the map, this function replaces the original value of the key with the new associated value.


icon

Inputs/Outputs

  • cmap.png map in —

    map in specifies the map in which you want to insert a key-value entry. This input accepts a map of any data type. The default data type is a map of 32-bit signed integers.

  • cstr.png key —

    key specifies the key of the entry to insert into the map.

    The key must be of the same data type as the existing keys in the map.

  • ci32.png value —

    value specifies the value of the entry. This input must be of the same data type as the existing values in the map.

  • imap.png map out —

    map out returns the map with the inserted entry.

  • ibool.png key already included? —

    key already included? returns whether map in already includes key. If key already included? is TRUE, this function replaces the associated value of key in map in with value and returns the resulting map in map out.

  • ibool.png value unchanged? —

    value unchanged? returns whether any values in the input map are updated after the insertion.

    • Examples

    Refer to the following example files included with LabVIEW.

    • labview\examples\Collections\Map Collection - Comparing Test Results.vi