.. highlightlang:: us

.. index:: clear

.. _clear:

clear
=====

.. us.tag  clear ENGLISH Programming.Symboltable Changed5300

:ref:`clear` removes a variable or a function from memory.

.. function::   n = clear()
                n = clear(ssName)

.. us.return

**Return Value**

If the function succeeds, the return value *n* is the number auf removed
variables. If the function fails, the return value is 0.

.. us.params

**Parameters**

.. uparam:: ssName

   *ssName* is the name of the function or variable.

.. us.comment

**Comment**

If the function is invoked without parameters all global variables will
be removed which are not starting with an underscore ``_``or the characters ``g_``.

Functions loaded with :ref:`loadlib` cannot be removed.

.. us.example

**Example**

::

   a = 1
   clear("a")
       1.0000
   print a

   >>> (E0000014) a : Variable not defined

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.30
     - Can be invoked without parameters. 

.. seealso::
   :ref:`overview-programming`,
   :ref:`what`,
   :ref:`who`,
   :ref:`whos`,
   :ref:`load`,
   :ref:`loadlib`

:sub:`id-1110517`