ftell(3) Manpage

Manpage — FSEEK

BEZEICHNUNG

fgetpos, fseek, fsetpos, ftell, rewind - positioniere einen Stream neu

Ü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, fpos_t *pos);

BESCHREIBUNG

Die Funktion fseek setzt den Dateipositionszeiger für den Stream, auf den stream zeigt. Die neue Position, gemessen in Byte, wird erreicht durch addieren von offset zu der Position, die durch whence angegeben ist. Wenn whence auf SEEK_SET, SEEK_CUR, oder SEEK_END, gesetzt ist, ist der Offset relativ zum Dateianfang, der aktuellen Position, oder dem Dateiende. Ein erfolgreicher Aufruf der Funktion fseek löscht den Dateiendezeiger für den Stream und macht den Effekt der Funktion ungetc(3) Rückgängig für den Stream.

Die Funktion ftell holt der aktuellen Wert des Dateipositionszeigers für den Stream, auf den stream zeigt.

Die Funktion rewind setzt den Dateipositionszeigers für den Stream, auf den stream zeigt, auf den Dateianfang. Sie ist äquivalent zu:

(void)fseek(stream, 0L, SEEK_SET)

außer daß der Fehlerindikator für den Stream auch gelöscht wird (siehe clearerr(3).

Die Funktionen fgetpos und fsetpos sind alternative Schnittstellen zu ftell und fseek (mit whence gesetzt auf SEEK_SET), die den aktuellen Wert des Dateioffsets lesen oder setzen von dem oder auf das Objekt angegeben durch pos. Auf einigen Nicht-UNIX-Systemen kann ein Objekt fpos_t ein komplexes Objekt sein, und diese Routinen können der einzige Weg sein, den Dateizeiger portabel zu beeinflussen.

RÜCKGABEWERTE

Die Funktion rewind gibt keinen Wert zurück. Bei erfolgreichem Abschluss geben fgetpos, fseek, fsetpos 0 zurück, während ftell den aktuellen Offset zurückgibt. Anderenfalls wird -1 zurückgegeben und die globale Variable errno gesetzt um den Fehler anzuzeigen.

FEHLER

SIEHE AUCH

KONFORM ZU

Die Funktionen fgetpos, fsetpos, fseek, ftell, und rewind sind konform zu ANSI C3.159-1989 (``ANSI C'').

31. Dezember 1996

FSEEK (3)

BSD MANPAGE

Bitte richten Sie Ihre Kommentare zu diesem Handbuch Seite Service, Ben Bullock. Privacy policy.

“	Modern Unix impedes progress in computer science, wastes billions of dollars, and destroys the common sense of many who seriously use it.	”
— The Unix Haters' handbook

EBADF	Der angegebene stream ist nicht positionierbar.
EINVAL	Das Argument whence für fseek war nicht SEEK_SET, SEEK_END, oder SEEK_CUR.