.. highlightlang:: us

.. index:: DS_GetValue

.. _ds_getvalue:

DS_GetValue
===========

.. us.tag DS_GetValue NOTREADYENGLISH DataSource New5200

:ref:`DS_GetValue` returns an attribute from the "Datasource" map.

.. function:: value = DS_GetValue(hData, ssKey, default)

.. us.return

**Return Value**

*value* is the value for *ssKey* or the default value given in the *default*
parameter, if the key is not available in the datasource map.

.. us.params

**Parameters**

.. uparam:: hData

   *hData* is the dataset handle.

.. uparam:: ssKey

   *ssKey* is the key (see :ref:`overview-data-file-informations-for-datasets`).

.. uparam:: default

   *default* is a value that will be returned if *ssKey* is not available.

.. us.example

**Example**

::

  nFirstPointLoaded = DS_GetValue(hData, "FirstPoint", 0);

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.20
     - New.

.. seealso::
   :ref:`overview-data-file-informations-for-datasets`

:sub:`id-1676435`