.. highlightlang:: us

.. index:: DeCompressFile

.. _decompressfile:

DeCompressFile
==============

.. us.tag  DeCompressFile GERMAN file-zip New300 Changed5140

:ref:`DeCompressFile` dekomprimiert eine mit :ref:`CompressFile` komprimierte
Datei.

.. function::  bool = DeCompressFile(ssFilename)
   bool = DeCompressFile(ssFilename, ssFilenameOut)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: ssFilename

   Falls ``DeCompressFile()`` mit einem Parameter aufgerufen wird, ist
   *ssFilename* ist der Name der Datei **ohne** Extension. Die Datei muss in
   diesem Fall die Extension ``.Z`` haben.

   Falls ``DeCompressFile()`` mit zwei Parametern aufgerufen wird, muss
   *ssFilename* den kompletten Dateinamen inklusive Extension enthalten.

.. uparam:: ssFilenameOut

   *ssFilenameOut* ist der Name der Ausgabedatei.

.. us.comment

**Kommentar**

Diese Funktion verwendet die zlib-Library (http://www.gzip.org/zlib/).
Copyright (C) 1995-1998 Jean-loup Gailly and Mark Adler.

.. us.example

**Beispiel**

Der folgende Aufruf entpackt die Datei :file:`d:\\Test.dat.Z`.
Es wird die Datei :file:`Test.dat` erzeugt.

::

   DeCompressFile("d:\Test.dat")

Der folgende Aufruf entpackt die Datei :file:`d:\\Test.tar.gz`.
Es wird die Datei :file:`Test.tar` erzeugt.

::

   DeCompressFile("d:\Test.tar.gz", "d:\Test.tar")

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.14.0
     - Aufruf mit zwei Parametern
   * - 3.0
     - Neu

.. seealso::
   :ref:`file-zip`,
   :ref:`CompressFile`,
   :ref:`mem_compress`

:sub:`id-1211081`