Provided by: manpages-de-dev_2.5-1_all 
BEZEICHNUNG
fgetpos, fseek, fsetpos, ftell, rewind - Neupositionierung eines Streams
ÜBERSICHT
#include <stdio.h>
int fseek(FILE *stream, long offset, int whence);
long ftell(FILE *stream);
void rewind(FILE *stream);
int fgetpos(FILE *stream, fpos_t *pos);
int fsetpos(FILE *stream, const fpos_t *pos);
BESCHREIBUNG
Die Funktion fseek() setzt den Datei-Positionszeiger für den Stream stream. Die neue, in
Byte gemessene Position ergibt sich durch die Addition von offset (Versatz) zu der durch
whence angegebenen Position. Wenn whence auf SEEK_SET, SEEK_CUR oder SEEK_END gesetzt ist,
ist der Versatz relativ zum Dateianfang, der aktuellen Position oder dem Dateiende. Ein
erfolgreicher Aufruf von fseek() löscht den Dateiendezeiger für den Stream und macht alle
Auswirkungen der Funktion ungetc(3) für den Stream rückgängig.
Die Funktion ftell() beschafft den aktuellen Wert des Dateipositionszeigers für den
Stream, auf den stream zeigt.
Die Funktion rewind() setzt den Dateipositionszeiger für den Stream, auf den stream zeigt,
auf den Dateianfang. Sie ist äquivalent zu
(void) fseek(stream, 0L, SEEK_SET)
löscht aber zusätzlich den Fehlerindikator für den Stream (siehe clearerr(3)).
Die Funktionen fgetpos() und fsetpos() sind alternative Schnittstellen und gleichwertig zu
ftell() und fseek() (mit whence auf SEEK_SET gesetzt). Sie bestimmen den aktuellen Wert
des Dateiversatzes und speichern ihn in oder von dem durch pos referenzierten Objekt. Auf
einigen Nicht-UNIX-Systemen kann ein Objekt fpos_t ein komplexes Objekt sein. Diese
Routinen können der einzige Weg sein, einen Text-Stream portabel neu zu positionieren.
RÜCKGABEWERT
Die Funktion rewind() gibt keinen Wert zurück. Bei erfolgreichem Abschluss geben
fgetpos(), fseek(), fsetpos() 0 zurück; ftell() den aktuellen Versatz. Anderenfalls wird
-1 zurückgegeben und errno gesetzt, um den Fehler anzuzeigen.
FEHLER
EBADF Der angegebene Stream ist nicht durchsuchbar.
EINVAL Das Argument whence für fseek() war nicht SEEK_SET, SEEK_END oder SEEK_CUR. Oder:
der entstehende Datei-Versatz wäre negativ.
Die Funktionen fgetpos(), fseek(), fsetpos() und ftell() können auch fehlschlagen und
errno für alle Fehler setzen, die für die Routinen fflush(3), fstat(2), lseek(2) und
malloc(3) festgelegt sind.
ATTRIBUTE
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
┌────────────────────────────┬───────────────────────┬─────────┐
│Schnittstelle │ Attribut │ Wert │
├────────────────────────────┼───────────────────────┼─────────┤
│fseek(), ftell(), rewind(), │ Multithread-Fähigkeit │ MT-Safe │
│fgetpos(), fsetpos() │ │ │
└────────────────────────────┴───────────────────────┴─────────┘
KONFORM ZU
POSIX.1-2001, POSIX.1-2008, C89, C99.
SIEHE AUCH
lseek(2), fseeko(3)
KOLOPHON
Diese Seite ist Teil der Veröffentlichung 4.15 des Projekts Linux-man-pages. Eine
Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die
aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.
ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Patrick Rother <krd@gulu.net>,
Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> und Mario Blättermann
<mario.blaettermann@gmail.com> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License
Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG
übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-
Mail an <debian-l10n-german@lists.debian.org>.