fsetpos

Nach oben zu stdio.h - Index

Header-Datei

stdio.h

Kategorie

Eingabe-/Ausgaberoutinen

Prototyp

int fsetpos(FILE *stream, const fpos_t *pos);

Beschreibung

Positioniert den Dateizeiger eines Streams.

fsetpos setzt den mit einem Stream verbundenen Dateizeiger an eine neue Position. Die neue Position ist der über einen Aufruf von fgetpos für diesen Stream ermittelte Wert. Die Funktion setzt auch den Dateiende-Indikator der mit dem Stream verbundenen Datei zurück und verwirft alle mit ungetc zurückgesendeten Zeichen. Nach dem Aufruf von fsetpos kann die nächste Operation mit der Datei eine Eingabe oder eine Ausgabe sein.

Rückgabewert

Bei erfolgreicher Ausführung gibt fsetpos 0 zurück.

Bei einem Fehler wird ein Wert ungleich Null zurückgegeben und die globale Variable errno ebenfalls auf einen Wert ungleich Null gesetzt.

Portabilität

POSIX	Win32	ANSI C	ANSI C++
+	+	+	+