Loading...
stdio/fseek.3 Libc-583 Libc-262
--- Libc/Libc-583/stdio/fseek.3
+++ Libc/Libc-262/stdio/fseek.3
@@ -34,9 +34,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)fseek.3	8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/stdio/fseek.3,v 1.25 2004/03/20 08:38:27 tjr Exp $
-.\"
-.Dd March 19, 2004
+.\" $FreeBSD: src/lib/libc/stdio/fseek.3,v 1.19 2001/10/01 16:08:59 ru Exp $
+.\"
+.Dd March 5, 1999
 .Dt FSEEK 3
 .Os
 .Sh NAME
@@ -53,39 +53,20 @@
 .Sh SYNOPSIS
 .In stdio.h
 .Ft int
-.Fo fgetpos
-.Fa "FILE *restrict stream"
-.Fa "fpos_t *restrict pos"
-.Fc
-.Ft int
-.Fo fseek
-.Fa "FILE *stream"
-.Fa "long offset"
-.Fa "int whence"
-.Fc
-.Ft int
-.Fo fseeko
-.Fa "FILE *stream"
-.Fa "off_t offset"
-.Fa "int whence"
-.Fc
-.Ft int
-.Fo fsetpos
-.Fa "FILE *stream"
-.Fa "const fpos_t *pos"
-.Fc
+.Fn fseek "FILE *stream" "long offset" "int whence"
 .Ft long
-.Fo ftell
-.Fa "FILE *stream"
-.Fc
+.Fn ftell "FILE *stream"
+.Ft void
+.Fn rewind "FILE *stream"
+.Ft int
+.Fn fgetpos "FILE *stream" "fpos_t *pos"
+.Ft int
+.Fn fsetpos "FILE *stream" "const fpos_t *pos"
+.In sys/types.h
+.Ft int
+.Fn fseeko "FILE *stream" "off_t offset" "int whence"
 .Ft off_t
-.Fo ftello
-.Fa "FILE *stream"
-.Fc
-.Ft void
-.Fo rewind
-.Fa "FILE *stream"
-.Fc
+.Fn ftello "FILE *stream"
 .Sh DESCRIPTION
 The
 .Fn fseek
@@ -111,9 +92,7 @@
 function clears the end-of-file indicator for the stream and undoes
 any effects of the
 .Xr ungetc 3
-and
-.Xr ungetwc 3
-functions on the same stream.
+function on the same stream.
 .Pp
 The
 .Fn ftell
@@ -168,37 +147,21 @@
 and
 .Fn fsetpos
 functions
-are alternate interfaces for retrieving and setting the current position in
-the file, similar to
+are alternate interfaces equivalent to
 .Fn ftell
 and
-.Fn fseek ,
-except that the current position is stored in an opaque object of
-type
-.Vt fpos_t
-pointed to by
+.Fn fseek
+(with whence set to
+.Dv SEEK_SET ) ,
+setting and storing the current value of
+the file offset into or from the object referenced by
 .Fa pos .
-These functions provide a portable way to seek to offsets larger than
-those that can be represented by a
-.Vt long int .
-They may also store additional state information in the
-.Vt fpos_t
-object to facilitate seeking within files containing multibyte
-characters with state-dependent encodings.
-Although
-.Vt fpos_t
-has traditionally been an integral type,
-applications cannot assume that it is;
-in particular, they must not perform arithmetic on objects
-of this type.
-.Pp
-If the stream is a wide character stream (see
-.Xr fwide 3 ) ,
-the position specified by the combination of
-.Fa offset
-and
-.Fa whence
-must contain the first byte of a multibyte sequence.
+On some
+.Pq non- Ns Tn UNIX
+systems an
+.Dq Fa fpos_t
+object may be a complex object
+and these routines may be the only way to portably reposition a text stream.
 .Sh RETURN VALUES
 The
 .Fn rewind
@@ -220,7 +183,7 @@
 .It Bq Er EBADF
 The
 .Fa stream
-argument
+specified
 is not a seekable stream.
 .It Bq Er EINVAL
 The
@@ -265,29 +228,10 @@
 .Xr lseek 2 ,
 and
 .Xr malloc 3 .
-.Sh LEGACY SYNOPSIS
-.Fd #include <stdio.h>
-.Fd #include <sys/types.h>
-.Pp
-.Ft int
-.br
-.Fo fseeko
-.Fa "FILE *stream"
-.Fa "off_t offset"
-.Fa "int whence"
-.Fc ;
-.Pp
-The include file
-.In sys/types.h
-supplies the definition for
-.Vt off_t .
 .Sh SEE ALSO
 .Xr lseek 2 ,
 .Xr clearerr 3 ,
-.Xr fwide 3 ,
-.Xr ungetc 3 ,
-.Xr ungetwc 3 ,
-.Xr compat 5
+.Xr ungetc 3
 .Sh STANDARDS
 The
 .Fn fgetpos ,
@@ -305,4 +249,4 @@
 and
 .Fn ftello
 functions conform to
-.St -p1003.1-2001 .
+.St -susv2 .