.. highlightlang:: us

.. index:: units_get_si_unit

.. _units_get_si_unit:

units_get_si_unit
=================

.. us.tag units_get_si_unit NOTREADYENGLISH units New5511

:ref:`units_get_si_unit` returns the SI unit for the given unit.

.. function:: ssUnitSI = units_get_si_unit(oUnit, ssUnit)

.. us.return

**Return Value**

*ssUnitSI* is a unit from the unit table, column "SI Unit" (see
:ref:`overview-units`). If the unit is unknown the return value is an empty
string.

.. us.params

**Parameters**

.. uparam:: oUnit

   Is the unit converter object, returned by :ref:`units`.

.. uparam:: ssUnit

   *ssUnit* is one of the defined units (see :ref:`overview-units`).

.. us.comment

**Comment**

The ``units_get_si_unit(oUnit, ssUnit)`` can also be invoked in the following 
form: ``oUnit.si(ssUnit)``.

.. us.example

**Example**

::

   o = units()
   units_get_si_unit(o, "HP")
   W

.. us.history

**History**

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

   * - Version
     - Description
   * - R2013.11
     - New.

.. seealso::
   :ref:`overview-units`,
   :ref:`units`,
   :ref:`units_get_preferred_unit`

:sub:`id-1130398`