.. highlightlang:: us

.. index:: mem_uncompress

.. _mem_uncompress:

mem_uncompress
==============

.. us.tag  mem_uncompress GERMAN New420 Changed606 mem file-zip

:ref:`mem_uncompress` dekomprimiert einen mit :ref:`mem_compress` komprimierten String
oder einen mit der zlib komprimierten String.

.. function::  ssString = mem_uncompress(ssStringCompressed)
               ssByteString = mem_uncompress(ssByteCompressed, nDestLen)

.. us.return

**Returnwert**

*ssString* ist ein skalarer String der auch Null-Zeichen enthalten kann.

*ssByteString*: Bei Aufruf mit 2 Parametern enthält *ssByteString* die
dekomprimierten Daten.

.. us.params

**Parameter**

.. uparam:: ssStringCompressed

   *ssStringCompressed* ist der mit :ref:`mem_compress` komprimierte String. Der
   String muss einen Header enthlaten. Siehe :ref:`mem_compress`.

.. uparam:: ssByteCompressed

   *ssByteCompressed* ist ein zlib komprimierte String. Der
   String enhält keinen Header.

.. uparam:: nDestLen

   *nDestLen* ist die Länge in Bytes des dekomprimierten Strings.

ssByteCompressed

.. us.example

**Beispiel**

siehe :ref:`mem_compress`.

Aufruf mit 2 Parametern::

   def test_mem_compress()
   {
      ssData = "Hello World, this is the data to compress";
      c = mem_compress(ssData);

      // Remove 8 byte header
      nbytes = mem_len(c);
      ssCompressed = mem_get(c, 9, nbytes-8);

      ssD= mem_uncompress(ssCompressed, strlen(ssData));
      ssData2 = mem_unpack(ssD);
      if (ssData2 != ssData) {
      error();
      }
   }

.. 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.history

**History**

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

   * - Version
     - Beschreibung
   * - R2018.6
     - Neuer Parameter *nDestLen*.
   * - 5.0.0
     - ???
   * - 4.2.0
     - Neu

.. seealso::
   :ref:`uberblick-strings`,
   :ref:`file-zip`,
   :ref:`mem_compress`,
   :ref:`CompressFile`,
   :ref:`DeCompressFile`

:sub:`id-290043`