.. highlightlang:: us

.. index:: zip_list

.. _zip_list:

zip_list
========

.. us.tag  zip_list NOTREADYGERMAN New500 file-zip

:ref:`zip_list` liefert Informationen zum Inhalt von Zip-Archiven.

.. note::

   Dies ist eine veraltete Funktion. Verwenden Sie :ref:`p7z_list`.

.. function::  ret = zip_list(ssZipfile)
    ret = zip_list(ssZipfile, svOptions)
    ret = zip_list(ssZipfile, svOptions, svMatch)

.. us.return

**Returnwert**

*ret* ist entweder ein Error-Objekt (siehe :ref:`error_create`) falls ein Fehler
aufgetreten ist, oder eine String-Matrix mit Datei-Informationen. Die
String-Matrix hat 1 oder 8 Spalten je nach Parameter *svOptions*.

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

   * - name
     - Name der Datei
   * - size
     - Größe der Datei in Bytes (entpackt)
   * - csize
     - Größe der Datei in Bytes (gepackt)
   * - date
     - Datum
   * - time
     - Zeit
   * - method
     - Kompressions-Methode
   * - crc-32
     - Prüfsumme
   * - encrypt
     - Verschlüsselt: "P", unverschlüsselt: "-"

.. us.params

**Parameter**

.. uparam:: ssZipfile

   *ssZipfile* ist der vollstängige Name der Zip-Datei.

.. uparam:: svOptions

   *svOptions* ist ein String mit einer der folgenden Optionen:

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

      * - Wert
        - Bedeutung
      * - "shortlisting", "short", "s"
        - Es werden nur die Dateinamen aufgelistet.
      * - "longlisting", "long", "l"
        - Es werden neben den Dateinamen noch weitere  Informationen ausgegeben
          (siehe Returnwert).

.. uparam:: svMatch

   *svMatch* ist ein Muster um die Anzahl an aufgelisteten Dateien
   einzuschränken. Es können ``"*"`` und ``"?"`` verwendet werden.

.. us.example

**Beispiel**

::

   smFilenames = zip_list("c:/test.zip", "longlisting", "*.exe")

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.0.0
     - Neu

.. seealso::
   :ref:`file-zip`,
   :ref:`zip_unzip`

:sub:`id-213908`