.. highlightlang:: us

.. index:: p7z_zip

.. _p7z_zip:

p7z_zip
=======

.. us.tag p7z_zip NOTREADYGERMAN file-zip New5510

:ref:`p7z_zip` erzeugt zip- und 7z-Archive.

.. function:: ret = p7z_zip(ssZipFile, ssRootDirectory, svFiles)
              ret = p7z_zip(ssZipFile, ssRootDirectory, svFiles, svOptions)

.. us.return

**Returnwert**

*ret* ist 0, wenn die Funktion erfolgreich war, und ein error-Objekt (siehe
:ref:`error_create`) im Fehlerfall.

.. us.params

**Parameter**

.. uparam:: ssZipFile

   *ssZipFile* ist der Name des Archivs.

.. uparam:: ssRootDirectory

   Vor Ausführung des Befehls wird in das Verzeichnis *ssRootDirectory*
   gesprungen. Der Parameter muss einen gültigen Pfad enthalten.

.. uparam:: ssFiles

   *svFiles* ist ein String Vektor mit Datei- und Verzeichnisnamen. Die Elemente
   können Wildcards enthalten. Die Verzeichnisse
   können entweder vollständig sein (z. B. ``d:\a\b``) oder relativ zu
   *ssRootDirectory* (z. B. *ssRootDirectory* ist ``d:\``, dann kann *svFiles*
   ``a`` oder ``a\b`` sein.

.. uparam:: svOptions

   *svOptions* sind zusätzliche Optionen. Die möglichen Optionen sind in der
   Datei ``<uniplot>\program\7zip`` beschrieben. Beispiele:

   .. list-table::

      * - "-pGeheim"
        - Passwort setzen ("Geheim").
      * - "-mem=AES256"
        - (Nur zip_format). Sichere AES256-Verschlüsselung verwenden.
      * - "-mhe=on"
        - (Nur 7z-Dateien). Auch die Archiv-Header (Dateinamen etc. )
          verschlüsseln.

.. us.comment

**Kommentar**

Diese Funktion verwendet die "7-Zip Command Line Version". Das Programm
(``7za.exe``), die Lizenz und die Dokumentation (``7-zip.chm``) finden Sie im
Verzeichnis ``<uniplot>\program\7zip``.

Siehe auch: http://de.wikipedia.org/wiki/7-Zip und http://www.7-zip.org/.

.. us.example

**Beispiel**

::

   p7z_zip("d:\\test.zip", "c:\\uniplot", ["program", "script"]);

::

   p7z_zip("d:\\test.zip", "c:\\uniplot", ["program", "script"], "-pGeheim");

::

   p7z_zip("d:\\test.zip", "c:\\uniplot", ["program", "script"], "-pGeheim -mem=AES256");

::

   p7z_zip("d:\\test.7z", "c:\\uniplot", ["program", "script"]);

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2013.10
     - Neu.

.. seealso::
   :ref:`file-zip`,
   :ref:`p7z_unzip`,
   :ref:`p7z_unzip_buffer`,
   :ref:`p7z_list`

:sub:`id-1889706`