.. highlightlang:: us

.. index:: us_set_breakpoint

.. _us_set_breakpoint:

us_set_breakpoint
==================

.. us.tag us_set_breakpoint NOTREADYGERMAN New5800 Programming.Debug

:ref:`us_set_breakpoint` setzt einen Anhaltepunkt (Breakpoint). Wenn die 
Funktion innerhalb einer Script-Funktion aufgerufen wird, wird der Haltepunkt
in der nächsten Zeile aktiviert. Die Zeile sollte keine Kommentarzeile sein.
Der Dateipfad der UniScriptdatei muss im Suchpfad für UniScript-Dateien 
enthalten sein (``uniscript-path``).

Die Funktion ist besonders nützlich, wenn UniPlot beispielsweise
über die Kommandozeile gestart wird.

.. function::  bool = us_set_breakpoint()
               bool = us_set_breakpoint(nLine)
               bool = us_set_breakpoint(ssFile)
               bool = us_set_breakpoint(ssFile, nLine)

.. us.params

**Parameter**

.. uparam:: nLine

   *nLine* ist die Zeilennummer. In dieser Zeile muss sich eine Anweisung
   befinden (keine Leerzeile oder Kommentarzeile). Die angegebene Zeilennummer
   muss auf eine Programmzeile verweisen, die nach dem Aufruf von 
   :ref:`us_set_breakpoint` durchlaufen wird.

.. uparam:: ssFile

   *ssFile* ist der vollständige Dateiname mit Pfad.

.. us.comment

**Kommentar**

Mit dem Aufruf von :ref:`us_path` wird der Pfad der Quelldatei der
Environment-Variable ``uniscript-path`` zugefügt.
Die Änderung wird **nicht** dauerhaft in der Environment-Variable gespeichert.
Die Programmausführung  wird dann in der Zeile ``a = 1;`` unterbrochen.
Falls die Quelldatei nicht über den ``uniscript-path`` gefunden wird, wird
die Programmausführung nicht unterbrochen.

::

   def MyTest()
   {
       us_path("add", "d:/myuniplot/");
       us_set_breakpoint();
       a = 1;   // will stop execution here
   }

.. ------------------------------------------------------------------------------

.. index:: us_get_breakpoints

.. _us_get_breakpoints:

us_get_breakpoints
==================

.. us.tag  us_get_breakpoints NOTREADYGERMAN New5800 Programming.Debug

:ref:`us_get_breakpoints` liefert eine Liste von Breakpoints (String-Array) der 
Form ``filename|lineno``.

.. function::  svBreakpoints = us_get_breakpoints()

.. ------------------------------------------------------------------------------

.. index:: us_remove_breakpoints

.. _us_remove_breakpoints:

us_remove_breakpoints
=====================

.. us.tag  us_remove_breakpoints NOTREADYGERMAN New5800 Programming.Debug

:ref:`us_remove_breakpoints` entfernt alle Breakpoints.

.. function::  bool = us_remove_breakpoints()

.. ------------------------------------------------------------------------------

.. us.history

**History**

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

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

.. seealso::
   :ref:`overview-programming`,
   :ref:`us_path`

:sub:`id-809299`