.. highlightlang:: us

.. index:: p7z_list

.. _p7z_list:

p7z_list
========

.. us.tag p7z_list NOTREADYENGLISH file-zip New5510

:ref:`p7z_list` returns a list of file names of a ZIP or 7z archive.

.. function:: svFiles = p7z_list(ssZipFile)
              svFiles = p7z_list(ssZipFile, svOptions)

.. us.return

**Return Value**

*svFiles* is a string vector with file names. In case of an error the function 
returns an error object (see :ref:`error_create`).

.. us.params

**Parameters**

.. uparam:: ssZipFile

   *ssZipfile* is the complete file name of the ZIP or 7z file.

.. uparam:: svOptions

   *svOptions* are extra parameters, e. g. "-pMyPassword" to set a password. 
   See :ref:`p7z_zip`.

.. us.comment

**Comment**

The function uses the "7-Zip Command Line Version". The program
(``7za.exe``), the license and the documentation (``7-zip.chm``) can be found in
``<uniplot>\program\7zip`` folder.

See also: http://en.wikipedia.org/wiki/7-Zip und http://www.7-zip.org/.

.. us.example

**Example**

::

   svFiles = p7z_list("d:/test.zip", "-pGeheim");

.. us.history

**History**

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

   * - Version
     - Description
   * - R2013.10
     - New.

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

:sub:`id-1878867`