.. highlightlang:: us

.. index:: MapSave

.. _mapsave:

MapSave
=======

.. us.tag  MapSave NOTREADYENGLISH Map_Set Changed500

The :ref:`MapSave` function saves the data elements of a map in a file.

.. function::  bool = MapSave(hMap, ssFileName)

.. 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:: ssFileName

   *ssFileName* is a string that names the file. If the file already exists, it
   is truncated to zero length before the data is saved.

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.0.0
     - In UniPlot 5 strings are saved as Unicode (UTF-8) in map files. Maps created with UniPlot 5.x cannot be read with UniPlot 4.x.

.. seealso::
   :ref:`overview-map`,
   :ref:`MapCreate`,
   :ref:`MapLoad`

:sub:`id-784055`