.. highlightlang:: us

.. _fseek:

fseek
=====

.. index:: fseek

.. us.tag  fseek GERMAN ffiles Changed530

:ref:`fseek` verändert die Position des nächsten Zugriffs in einer Datei.

.. function::  bool = fseek(fh)
    bool = fseek(fh, nSeek)
    bool = fseek(fh, nSeek, nOrigin)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: fh

   *fh* ist eine Datei-Zugriffsnummer (file handle), die die Funktion
   :ref:`fopen` erzeugt hat.

.. uparam:: nSeek

   *nSeek* ist die Position des nächsten Zugriffs abhängig von *nOrigin*. Wenn
   :ref:`fseek` nur mit einem Parameter aufgerufen wurde, wird die Dateiposition an den
   Anfang der Datei gesetzt.

.. uparam:: nOrigin

   *nOrigin* ist einer der folgenden Werte:

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

   * - Wert
     - Bedeutung
   * - SEEK_CUR (1)
     - Aktuelle Position.
   * - SEEK_END (2)
     - Ende der Datei.
   * - SEEK_SET (0)
     - Anfang der Datei (Defaultwert, wenn fseek nur mit einem oder zwei Argumenten aufgerufen wurde).

.. us.example

**Beispiel**

::

   fh = fopen("c:/test.bin", "w+");
   fwrite(fh, "int16", 1:100); // writes 100 short values
   print fseek(fh, -100, SEEK_CUR);
   rvValues = fread(fh, "int16", 50); // reads 50 short values
   fclose(fh);
   print rvValues';

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.3.0
     - *nSeek* kann größer als 32-Bit sein.

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

:sub:`id-625630`