diff options
Diffstat (limited to 'reference/C/MAN/fgetpos.htm')
| -rw-r--r-- | reference/C/MAN/fgetpos.htm | 163 |
1 files changed, 163 insertions, 0 deletions
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 @@ +<TITLE>fgetpos</TITLE> +<body bgcolor="#ffffcc"> +<hr> +<pre> + + + +<h3>FSEEK(3) Linux Programmer's Manual FSEEK(3) +</h3> + +<h3>NAME +</h3> fgetpos, fseek, fsetpos, ftell, rewind - reposition a + stream + +<h3>SYNOPSIS +</h3> #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); + +<h3>DESCRIPTION +</h3> 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. + +<h3>RETURN VALUES +</h3> 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. + +<h3>ERRORS +</h3> EBADF The stream specified is not a seekable stream. + + + + +<h3>BSD MANPAGE 29 November 1993 1 +</h3> + + + + +<h3>FSEEK(3) Linux Programmer's Manual FSEEK(3) +</h3> + + 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). + +</pre> +<hr> +<h3>SEE ALSO +</h3><p> +<a href=lseek.htm>lseek</a>, +<pre> + +<h3>STANDARDS +</h3> The fgetpos, fsetpos, fseek, ftell, and rewind functions + conform to ANSI C3.159-1989 (``ANSI C''). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +<h3>BSD MANPAGE 29 November 1993 2 +</h3> + +
</pre> +<P> +<hr> +<p> +<center> +<table border=2 width=80%> +<tr align=center> +<td width=25%> +<a href=../cref.html>Top</a> +</td><td width=25%> +<a href=../master_index.html>Master Index</a> +</td><td width=25%> +<a href=../SYNTAX/keywords.html>Keywords</a> +</td><td width=25%> +<a href=../FUNCTIONS/funcref.htm>Functions</a> +</td> +</tr> +</table> +</center> +<p> +<hr> + +This manual page was brought to you by <i>mjl_man V-2.0</i> |