.. highlightlang:: us

.. index:: updf_create_file

.. _updf_create_file:

updf_create_file
================

.. us.tag  updf_create_file GERMAN updf updf-stor New560 Changed5505 Changed5509

:ref:`updf_create_file` erzeugt eine neue UPDF-Datei.

.. function::  stg = updf_create_file(name)
               stg = updf_create_file(name, mode)

.. us.return

**Returnwert**

*stg* ist ein Storage-Pointer oder ein Error-Objekt, falls ein Fehler aufgetreten
ist (siehe :ref:`error_create`).

.. us.params

**Parameter**

.. uparam:: name

   *name* ist der Name der UPDF-Datei. Wird ``:memory:`` für den Dateinamen
   angegeben, wird die Datei im Speicher erzeugt.

.. uparam:: mode

   *mode* ist einer der folgenden Werte:

   .. list-table::
      :header-rows: 0

      * - UPDF_FAIL_IF_EXIST
        - Falls Datei existiert, wird die Datei nicht überschrieben,  sondern ein
          Fehlerwert zurück gegeben.
      * - UPDF_REPACKING
        - Falls Storages, Streams oder Attribute gelöscht werden, wird die Datei
          verkürzt. Falls dieses Flag nicht angegeben wird, wird der Speicherplatz
          für neue Objekte verwendet.
      * - UPDF_ZLIB_COMPRESSION
        - Verbesserte Kompession mit etwas schlechterer Performance.
      * - UPDF_LZ4_COMPRESSION
        - Sehr schnelle Kompression, siehe https://code.google.com/p/lz4/.

.. us.example

**Beispiel**

.. include:: ../include/test_updf_create_file.ic

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2013.9
     - ``UPDF_LZ4_COMPRESSION``. 
   * - R2013.5
     - ``:memory:`` für *name* dokumentiert. 
   * - 5.6.0
     - Neu

.. seealso::
   :ref:`uberblick-updf-dateien`,
   :ref:`updf_open_file`,
   :ref:`updf_close_storage`

:sub:`id-1891360`