.. highlightlang:: us

.. index:: updf_get_free_pages

.. _updf_get_free_pages:

updf_get_free_pages
===================

.. us.tag updf_get_free_pages NOTREADYGERMAN updf updf-stor New5500

:ref:`updf_get_free_pages` liefert die Anzahl an freien Seiten einer UPDF-Datei.

.. function:: nPages = updf_get_free_pages(stg)

.. us.return

**Returnwert**

*nPages* ist die Anzahl an freien Seiten.

.. us.params

**Parameter**

.. uparam:: stg

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

.. us.comment

**Kommentar**

Eine UPDF-Datei besteht aus Seiten der Größe 1024 Bytes. Wenn Elemente gelöscht
werden, entstehen leere Seiten, die bei der Erzeugung von Elementen wieder
verwendet werden. Falls die Datei mit dem ``UPDF_REPACKING``-Flag erzeugt wurde,
werden die freien Seiten beim Schließen der Datei entfernt, so dass sich die
Datei verkürzt. Dies führt jedoch zu Performance-Einbußen. Im Allgemeinen ist es
deshalb besser das ``UPDF_REPACKING``-Flag nicht zu verwenden, sondern falls sehr
viele freie Seiten vorhanden sind, die Datei zu packen indem eine neue UPDF-Datei
erzeugt wird und mit :ref:`updf_copy_to` die Streams und Storages in die neue
Datei kopiert werden.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2013 (5.50)
     - Neu.

.. seealso::
   :ref:`overview-UPDF-files`,
   :ref:`updf_create_file`,
   :ref:`updf_open_file`

:sub:`id-1760231`