.. highlightlang:: us

.. _updf_destroy_element:

updf_destroy_element
====================

.. index:: updf_destroy_element

.. us.tag  updf_destroy_element GERMAN updf updf-stor New560

:ref:`updf_destroy_element` löscht einen Stream oder Storage in einem Storage.

.. function::  ret = updf_destroy_element(stg, name)

.. us.return

**Returnwert**

*ret* ist TRUE (1) oder ein Error-Objekt, falls ein Fehler aufgetreten ist
(siehe :ref:`error_create`).

.. us.params

**Parameter**

.. uparam:: stg

   *stg* ist ein Storage-Objekt (siehe :ref:`updf_create_file`, :ref:`updf_open_file`,
   :ref:`updf_create_storage`).

.. uparam:: name

   *name* ist der Name des Streams oder Storages.

.. us.comment

**Kommentar**

Falls *name*   ein Storage ist, werden auch rekursiv alle Elemente (Streams und
Storages) gelöscht die er enthält.

.. us.example

**Beispiel**

.. include:: ../include/test_updf_destroy_element.ic

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.6.0
     - Neu

.. seealso::
   :ref:`uberblick-updf-dateien`,
   :ref:`updf_rename_element`

:sub:`id-1126673`