From 7e0f021a9aec35fd8e6725e87e3313b101d26f5e Mon Sep 17 00:00:00 2001 From: Tobias Klauser Date: Sun, 27 Jan 2008 11:37:44 +0100 Subject: Initial import (2.0.2-6) --- reference/C/MAN/fgetpos.htm | 163 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 163 insertions(+) create mode 100644 reference/C/MAN/fgetpos.htm (limited to 'reference/C/MAN/fgetpos.htm') diff --git a/reference/C/MAN/fgetpos.htm b/reference/C/MAN/fgetpos.htm new file mode 100644 index 0000000..dd76134 --- /dev/null +++ b/reference/C/MAN/fgetpos.htm @@ -0,0 +1,163 @@ +fgetpos + +
+
+
+
+
+

FSEEK(3) Linux Programmer's Manual FSEEK(3) +

+ +

NAME +

fgetpos, fseek, fsetpos, ftell, rewind - reposition a + stream + +

SYNOPSIS +

#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); + +

DESCRIPTION +

The fseek function sets the file position indicator for + the stream pointed to by stream. The new position, mea- + sured in bytes, is obtained by adding offset bytes to the + position specified by whence. If whence is set to + SEEK_SET, SEEK_CUR, or SEEK_END, the offset is relative to + the start of the file, the current position indicator, or + end-of-file, respectively. A successful call to the fseek + function clears the end-of-file indicator for the stream + and undoes any effects of the ungetc(3) function on the + same stream. + + The ftell function obtains the current value of the file + position indicator for the stream pointed to by stream. + + The rewind function sets the file position indicator for + the stream pointed to by stream to the beginning of the + file. It is equivalent to: + + (void)fseek(stream, 0L, SEEK_SET) + + except that the error indicator for the stream is also + cleared (see clearerr(3). + + The fgetpos and fsetpos functions are alternate interfaces + equivalent to ftell and fseek (with whence set to + SEEK_SET), setting and storing the current value of the + file offset into or from the object referenced by pos. On + some non-UNIX systems an fpos_t object may be a complex + object and these routines may be the only way to portably + reposition a text stream. + +

RETURN VALUES +

The rewind function returns no value. Upon successful + completion, fgetpos, fseek, fsetpos return 0, and ftell + returns the current offset. Otherwise, -1 is returned and + the global variable errno is set to indicate the error. + +

ERRORS +

EBADF The stream specified is not a seekable stream. + + + + +

BSD MANPAGE 29 November 1993 1 +

+ + + + +

FSEEK(3) Linux Programmer's Manual FSEEK(3) +

+ + EINVAL The whence argument to fseek was not SEEK_SET, + SEEK_END, or SEEK_CUR. + + The function fgetpos, fseek, fsetpos, and ftell may also + fail and set errno for any of the errors specified for the + routines fflush(3), fstat(2), lseek(2), and malloc(3). + +
+
+

SEE ALSO +

+lseek, +

+
+

STANDARDS +

The fgetpos, fsetpos, fseek, ftell, and rewind functions + conform to ANSI C3.159-1989 (``ANSI C''). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

BSD MANPAGE 29 November 1993 2 +

+ +
+

+


+

+

+ + + + +
+Top + +Master Index + +Keywords + +Functions +
+
+

+


+ +This manual page was brought to you by mjl_man V-2.0 -- cgit v1.2.3-54-g00ecf