.. highlightlang:: us

.. index:: excel_sheet_put_rows

.. _excel_sheet_put_rows:

excel_sheet_put_rows
====================

.. us.tag  excel_sheet_put_rows NOTREADYGERMAN excel excel-write New550

:ref:`excel_sheet_put_rows` schreibt ab der aktuellen Position Daten in eine 
Excel-Tabelle im Format biff 12 (Excel 2007, Endung .xlsx).

.. function::  nRows = excel_sheet_put_rows(oSheet, rmVal)
    nRows = excel_sheet_put_rows(oSheet, smStr)
    nRows = excel_sheet_put_rows(oSheet, rmVal, smStr)
    nRows = excel_sheet_put_rows(oSheet, rmVal, rmStyleIndex)
    nRows = excel_sheet_put_rows(oSheet, smStr, rmStyleIndex)
    nRows = excel_sheet_put_rows(oSheet, rmVal, smStr, rmStyleIndex)

.. us.return

**Returnwert**

*nRows* ist die Anzahl der geschriebenen Zeilen. Falls ein Fehler
aufgetreten ist, wird ein error Objekt zurückgegeben.

.. us.params

**Parameter**

.. uparam:: oSheet

   *oSheet* ist ein Objekt, das mit der Funktion :ref:`excel_sheet_open` oder
   :ref:`excel_sheet_create` erzeugt wurde.

.. uparam:: rmVal

   *rmVal* ist eine reelle Matrix. Die Anzahl der Spalten muss mit der Anzahl der
   Spalten der Excel-Tabelle übereinstimmen.

.. uparam:: smStr

   *smStr* ist ein Matrix mit Zeichenketten.  Die Anzahl der Spalten muss mit
   der Anzahl der Spalten der Excel-Tabelle übereinstimmen.

   Um bei einem Aufruf mit dem Parameter *rmVal* eine leere Zelle zu schreiben, 
   muss die entsprechende Zelle im Parameter *smStr* den String "\\t" enthalten. 
   
   Die Zahl wird geschrieben, wenn die Zelle im Parameter *smStr* den Wert ""
   besitzt.

.. uparam:: rmStyleIndex

   *rmStyleIndex* ist eine Matrix mit Stil-Indizes. Siehe Beispiel in 
   :ref:`excel_create`.

.. us.example

**Beispiel**

Siehe :ref:`excel_create`.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.5.0
     - Neu.

.. seealso::
   :ref:`uberblick-excel-dateien`,
   :ref:`excel_create`,
   :ref:`excel_sheet_create`,
   :ref:`excel_sheet_get_rows`

:sub:`id-1358086`