.. highlightlang:: us

.. index:: MapSetAt

.. _mapsetat:

MapSetAt
========

.. us.tag  MapSetAt NOTREADYENGLISH Map_Set Changed420

:ref:`MapSetAt` means to insert an element in a map. First, the key is looked up.
If the key is found, then the corresponding value is changed; otherwise a new
key-value pair is created.

.. function::  bool = MapSetAt(hMap, ssKey, dat)

.. us.return

**Return Value**

If the function succeeds, the return value *bool* is TRUE (1); otherwise it is
FALSE (0).

.. us.params

**Parameters**

.. uparam:: hMap

   *hMap* Identifies the map.

.. uparam:: ssKey

   *ssKey* specifies the key that identifies the element to be set up.

.. uparam:: dat

   *dat* is a real, complex or string matrix.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 4.2.0
     - The *dat*  parameter can contain 0-characters.

.. seealso::
   :ref:`overview-map`,
   :ref:`MapCreate`,
   :ref:`MapRemoveAt`,
   :ref:`MapLookup`

:sub:`id-2089637`