.. highlightlang:: us

.. index:: IpwInfo

.. _ipwinfo:

IpwInfo
=======

.. us.tag IpwInfo NOTREADYGERMAN ProgMisc New5145 Changed5400

:ref:`IpwInfo` liefert die Anzahl an Streams und die Gesamtgröße der Streams
in einer UniPlot-Datei.

.. function:: rvInfo = IpwInfo(ssFile)

.. us.return

**Returnwert**

*rvInfo* ist ein Vektor mit zwei Elementen. 

IPW-Dateien: ``rvInfo[1]`` enthält die Anzahl an Streams. ``rvInfo[2]`` enthält
die Summe aller Stream-Längen (Anzahl an Bytes).

IPZ-Dateien: ``rvInfo[1]`` enthält den Zahlenwert -1. ``rvInfo[2]`` enthält die
Anzahl an freien Bytes in der Datei.

.. us.params

**Parameter**

.. uparam:: ssFile

   *ssFile* ist der komplette Dateiname einer IPW- oder IPZ-Datei.

.. us.comment

**Kommentar**

IPW-Dateien sind Microsoft-Compound-Dateien (Verbund-Dokumente). Neben den
eigentlichen Daten enthalten sie noch ein Inhaltsverzeichnis und eine sogenannte
File Allocation Table (FAT), deren Größen in ``rvInfo[2]`` nicht enthalten sind.

.. us.example

**Beispiel**

::

   def test()
   {
      file = GetRootDirectory() + "samples\\sample.ipw";
      f = fopen(file, "rb");
      sizeFile = fgetlen(f);
      fclose(f);
      sizeInternal = IpwInfo(file)[2];
      print sizeFile, sizeInternal;
   }
   test();

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2012 (5.40.0)
     - Berücksichtigung von IPZ-Dateien.
   * - 5.14.5
     - Neu.

.. seealso::
   :ref:`uberblick-programmierung`

:sub:`id-273824`