.. highlightlang:: us

.. index:: MapCreate

.. _mapcreate:

MapCreate
=========

.. us.tag  MapCreate ENGLISH Map

:ref:`MapCreate` creates a new map object.

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

.. us.return

**Return Value**

*hMap* If the function succeeds, the return value is the handle of the newly
created map. If the function fails, the return value is 0.

.. us.params

**Parameters**

.. uparam:: nSize

   *nSize* For best performance, the hash table size should be a prime number. To
   minimize collisions the size should be roughly 20% larger than the largest
   anticipated dataset. Default value is 17.

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

:sub:`id-1243993`