.. highlightlang:: us

.. index:: ExcelWrite

.. _excelwrite:

ExcelWrite
==========

.. us.tag  ExcelWrite GERMAN

:ref:`ExcelWrite` schreibt Dateien, die von der Tabellenkalkulation Excel gelesen
werden können.

.. function::  bool = ExcelWrite(ssFileName, smMatrix, smType)
    bool = ExcelWrite(ssFileName, smMatrix)
    bool = ExcelWrite(ssFileName, rmMatrix)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Datei erfolgreich geschrieben werden konnte und
sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: ssFileName

   *ssFileName* ist der vollständige Dateiname, der normalerweise die Erweiterung
   :file:`.XLS` hat.

.. uparam:: smType

   *smType* ist eine String-Matrix, die die Typen der Matrix *smMatrix* enthält.

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

      * - Wert
        - Bedeutung
      * - ``"I"``
	- Das entsprechende Element von smMatrix in eine positive, ganze Zahl
	  im Bereich 0 bis 65535 umgewandelt.
      * - ``""`` (empty string)
	- Das entsprechende Element von smMatrix in eine reelle Zahl
	  umgewandelt.

      * - ``"S"``
	- Das entsprechende Element von *smMatrix* nicht umgewandelt, sondern
	  als Zeichenkette geschrieben.

.. uparam:: smMatrix

   *smMatrix* ist eine String-Matrix.

.. uparam:: rmMatrix

   *rmMatrix* ist eine reelle Matrix.

.. us.comment

**Kommentar**

Die Matrix darf maximal 16384 Zeilen und 255 Spalten haben.

Mit der Funktion :ref:`ExcelWriteEx` können .xlsx Dateien mit bis zu 1 Mio.
Zeilen geschrieben werden.

.. seealso::
   :ref:`uberblick-excel-dateien`,
   :ref:`ExcelRead`,
   :ref:`ExcelWriteEx`

:sub:`id-1241313`