.. highlightlang:: us

.. index:: MapCreate

.. _mapcreate:

MapCreate
=========

.. us.tag  MapCreate GERMAN Map

:ref:`MapCreate` erzeugt ein neues Map-Objekt.

.. function::  hMap = MapCreate()
               hMap = MapCreate(nSize)

.. us.return

**Returnwert**

*hMap* ist die Zugriffsnummer des erzeugten Map-Objekts oder 0, falls das
Map-Objekt nicht erzeugt werden konnte.

.. us.params

**Parameter**

.. uparam:: nSize

   Um einen schnellen Zugriff auf ein Element zu ermöglichen, verwenden Maps
   Hash-Tabellen. Um eine optimale Zugriffsgeschwindigkeit zu erreichen, sollte
   die Größe (Anzahl der zu speichernden Elemente) der Map mit Hilfe des
   Parameters *nSize* (oder der Funktion :ref:`MapInitHashTable`) initialisiert
   werden. Die Größe sollte eine Primzahl sein und um ca. 20% größer als die
   zu erwartende Anzahl der Elemente sein. Falls *nSize* nicht angegeben wird,
   wird *nSize* auf 17 gesetzt.

.. seealso::
   :ref:`uberblick-map`,
   :ref:`MapDestroy`,
   :ref:`MapInitHashTable`

:sub:`id-1243993`