.. highlightlang:: us

.. index:: units

.. _units:

units
=====

.. us.tag units NOTREADYGERMAN units New5511

:ref:`units` liefert das aktive Einheiten-Umrechner-Objekt.

.. function:: oUnit = units()

.. us.return

**Returnwert**

Ist das Einheiten-Umrechner-Objekt.

.. us.comment

**Kommentar**

Beim ersten Aufruf der Funktion wird die Excel-Datei gelesen, deren Name sich in
der Registry unter ``Settings\unit-converter-file`` (siehe auch
:ref:`uniplot-registry`) befindet.

::

   WriteProfileString("Settings", "unit-converter-file", ...
                   GetRootDirectory() + "Template/units.xlsx");

Wenn Sie Einheiten ändern möchten, kopieren Sie die Datei in ein anderes
Verzeichnis, z. B. in das UniPlot-Benutzerverzeichnis (siehe
:ref:`GetUserDirectory`) da die Datei :file:`units.xlsx` im
UniPlot-Template-Verzeichnis bei Installation eines Updates überschrieben wird.

Der Dateiname kann im Dialog :ref:`tools-formula-configuration` angegeben werden.

Alternativ können Sie den Namen im UniPlot-Kommandofenster eingeben::

   s = GetUserDirectory() + "Template/units.xls"
   WriteProfileString("Settings", "unit-converter-file", s);

Die aktive units-Datei können Sie über den folgenden Befehl bearbeiten::

   ShellExecute(units().excel_file)

.. us.example

**Beispiel**

::

   u = units()
   rvScale = units_get_scale(u, "HP", "PS")
   rvScale
       1.0139     0.0000 

   rvScale = u.scale("HP", "PS")
   rvScale
       1.0139     0.0000 

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2017.6
     - Die Default Einheitendatei units.xls wurde in das XLSX-Fomat konvertiert
       (units.xlsx). Bei der XLS-Datei traten Probleme mit einigen ANSI-Zeichen
       auf.
   * - R2013.11
     - Neu.

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

:sub:`id-680445`