## `prog::untrace` -- terminates observation of functions

#### Introduction

`prog::untrace(`obj`)` undoes the effect of `prog::trace(obj)` and restores the original definition of `obj`.

#### Call(s)

`prog::untrace(obj)`
`prog::untrace()`

#### Parameters

`obj` | - | the MuPAD function that is observed, or a domain or a function environment

#### Returns

`prog::untrace` returns the void object `null()`.

#### Related Functions

`prog::trace`, `setuserinfo`, `debug`, `prog::profile`, `prog::calltree`

#### Details

- `prog::untrace(`obj`)` terminates the observation of the MuPAD function `obj` performed by `prog::trace`.
- `obj` can be a domain or a function environment, too. Then all methods of the domain or function environment will be restored.
- If no argument is given, all observed objects will be restored from observation.

#### Example 1

The observation of a function will be terminated:

    >> prog::untrace(sin):

          Error: function was not traced [prog::untrace]

    >> prog::trace(sin):
       sin(2)

          enter 'sin'                            with args   : 2
          leave 'sin'                            with result : sin(2)

                                      sin(2)

    >> prog::untrace(sin):
       sin(2)

                                      sin(2)

#### Changes

- used to be called `sharelib::untrace`

Do you have questions or comments?
Copyright © SciFace Software GmbH & Co. KG 2000