.. highlightlang:: us

.. index:: IsFileText

.. _isfiletext:

IsFileText
==========

.. us.tag  IsFileText GERMAN FILE_MISC Changed500 Changed5100

:ref:`IsFileText` prüft, ob eine Datei eine Text-Datei (ASCII, OEM, ANSI, UNICODE)
ist.

.. function::  bool = IsFileText(ssFileName)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Datei eine Textdatei ist, oder FALSE (0), wenn die
Datei keine Textdatei ist oder nicht gelesen werden kann.

.. us.params

**Parameter**

.. uparam:: ssFileName

   *ssFileName* ist der vollständige Dateiname der Datei.

.. us.comment

**Kommentar**

Die Funktion prüft, ob sich in den ersten 4 kBytes einer Datei Null-Zeichen
befinden. Falls dies der Fall ist, gibt die Funktion FALSE zurück. Die Datei muss
dabei als Read-Only geöffnet werden können.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.10.0
     - Falls die Datei eine UNICODE-Datei ist und ein BOM (byte order mark) enthält, liefert die Funktion TRUE zurück.
   * - 5.0.0
     - Die Funktion kann nicht für Unicode-Dateien verwendet werden.

.. seealso::
   :ref:`uberblick-binar--und-text-dateien`,
   :ref:`IsFileExcel`,
   :ref:`IsFilenetCDF`,
   :ref:`GetFileAttributes`

:sub:`id-16930`