.. highlightlang:: us

.. index:: MapSetAt

.. _mapsetat:

MapSetAt
========

.. us.tag  MapSetAt NOTREADYGERMAN Map_Set Changed420

:ref:`MapSetAt`  fügt ein Datum in das Map-Objekt ein. Falls ein Datum mit einem
identischen Schlüssel bereits existiert, wird es überschrieben.

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

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: hMap

   *hMap* ist die Zugriffsnummer des mit :ref:`MapCreate` erzeugten Map-Objekts.

.. uparam:: ssKey

   *ssKey* ist eine skalare Zeichenkette, mit der auf das Element *dat*
   zugegriffen werden kann.

.. uparam:: dat

   *dat* ist eine reelle-, komplexe- oder String-Matrix.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 4.2.0
     - Im Parameter *dat* können auch Strings mit 0-Zeichen verwendet werden.

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

:sub:`id-2089637`