.. highlightlang:: us

.. index:: us_path

.. _us_path:

us_path
==================

.. us.tag us_path NOTREADYGERMAN New5800 Programming.Debug

:ref:`us_path` setzt oder erfragt die Environment-Variable ``uniscript-path``.

.. function::  svPath = us_path()
               ret = us_path(ssCommand)
               ret = us_path(ssCommand, ssPath)

.. us.params

**Parameter**

.. uparam:: ssCommand

   *ssCommand* ist einer der folgenden Strings:

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

      * - Kommando
        - Beschreibung
      * - ``"a"`` or ``"add"``
        - *ssPath* wird der Liste zugefügt.
      * - ``"g"`` or ``"get"``
        - Liefert die Environment-Variable ``"uniscript-path"``.
      * - ``"s"`` or ``"gets"``
        - Liefert die Environment-Variable ``"uniscript-path"`` zerlegt in
          einzelne Pfade.
      * - ``"m"`` or ``"match-remove"``
        - Entfernt Pfade aus ``"uniscript-path"``. Dabei können Suchmuster mit
          ``*`` und ``?`` angegeben werden, siehe :ref:`strmatch`.
      * - ``"r"`` or ``"remove"``
        - Entfernt einen einzelnen Pfad.

.. uparam:: ssPath

   *ssPath* ist ein Pfad.

.. us.comment

**Kommentar**

Die Funktion verändert bzw. erfragt die Environment-Variable ``uniscript-path``.
Die Änderungen werden **nicht** dauerhaft in der Environment-Variable gespeichert.
Die Pfade werden zum Beispiel vom UniScript-Debugger verwendet um den
vollständigen Namen einer UniScript-Datei zu ermitteln: 

::

   * search_path(getenv("uniscript-path"), "do_cmds.ic")
   D:\uniplot-64d\script\uniplot\do_cmds.ic
   * 

.. us.history

**History**

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

   * - Version
     - Description
   * - R2016.0
     - Neu.

.. seealso::
   :ref:`overview-programming`,
   :ref:`search_path`,
   :ref:`putenv`,
   :ref:`getenv`

:sub:`id-893639`