.. highlightlang:: us

.. _ffind:

ffind
=====

.. index:: ffind

.. us.tag  ffind GERMAN ffiles Changed500

:ref:`ffind` sucht ab der aktuellen Position in der Datei
nach dem ersten Auftreten einer Zeichenfolge.

.. function::  rsPosition = ffind(fh, ssText)
    rsPosition = ffind(fh, ssText, nBytes)

.. us.return

**Returnwert**

*rsPosition* ist die Anzahl der Bytes zwischen der aktuellen
Position und des ersten Zeichens der Zeichenfolge. Wird die
Zeichenfolge nicht gefunden, wird der Wert 0 zurückgegeben.

.. us.params

**Parameter**

.. uparam:: fh

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

.. uparam:: ssText

   *ssText* ist ein skalarer String, von dem die ersten 255 Zeichen für die Suche
   berücksichtigt werden.

.. uparam:: nBytes

   *nBytes* legt den Bereich fest, in dem nach der Zeichenkette gesucht wird. Wird
   kein Wert angegeben, wird bis zum Dateiende gesucht.

.. us.comment

**Kommentar**

**Wichtig**: Die Datei muss im Binär-Mode geöffnet werden.

.. us.example

**Beispiel**

::

   // Count lines
   i = 0;
   fh = fopen("c:/test.txt", "r");
   while (ffind(fh, "\n") != 0) {
       i = i + 1;
   }
   fclose(fh);
   print "No. of Lines:", i

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.0.0
     - Die Funktion kann wie bisher nicht für Unicode-Dateien verwendet werden.

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

:sub:`id-1838938`