.. highlightlang:: us

.. _fgetline:

fgetline
========

.. index:: fgetline

.. us.tag  fgetline GERMAN ffiles Changed500 Changed5100

:ref:`fgetline` liest ab der aktuellen Position bis zum Zeilenende aus der
angegebenen Datei.

.. function::  ssString = fgetline(fh)

.. us.return

**Returnwert**

*ssString* ist ein skalarer String, der die Zeile enthält. Im Fehlerfall bzw.
wenn das Dateiende erreicht ist, wird ein leerer String zurückgeliefert.

.. us.params

**Parameter**

.. uparam:: fh

   *fh* ist ein Filehandle, das durch Aufruf der Funktion :ref:`fopen` erzeugt wurde.

.. us.comment

**Kommentar**

Falls die Zeile mit einem Zeilentrennzeichen endet, wird ``\n`` zurückgegeben,
unabhängig davon, wie die Datei geöffnet wurde (Binär- oder Text-Mode). Die Zeile
kann beliebig lang sein. In der Datei können sich die folgenden 
Trennzeichen befinden:

.. list-table::
   :header-rows: 0

   * - 0x0D 0x0A (``\r\n``)
     - Windows
   * - 0x0a (``\n``)
     - Unix, Linux
   * - 0x0D (``\r``)
     - ältere Apple-Systeme

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.10.0
     - Es können nun auch UNICODE-Dateien (utf8, utf16-le, utf16) gelesen werden, falls in der Datei ein BOM (byte order mark) vorhanden ist und die Datei im  Textmode ("rt") geöffnet wurde (siehe :ref:`fopen`).
   * - 5.0.0
     - Es können wie auch in UniPlot 4.x nur Dateien mit 8-bit-Zeichensatz gelesen werden.

.. seealso::
   :ref:`uberblick-binar--und-text-dateien`,
   :ref:`fopen`,
   :ref:`fseek`,
   :ref:`feof`

:sub:`id-963517`