Libc-583.tar.gz

[apple/libc.git] / stdio / FreeBSD / fseek.3

diff --git a/stdio/FreeBSD/fseek.3 b/stdio/FreeBSD/fseek.3
index 8c78ce7828d4399579c733ea79532576d01c4f54..2f3518663eae855b65c91e3331cea566616d0498 100644 (file)
--- a/stdio/FreeBSD/fseek.3
+++ b/stdio/FreeBSD/fseek.3
@@ -34,9 +34,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)fseek.3    8.1 (Berkeley) 6/4/93
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)fseek.3    8.1 (Berkeley) 6/4/93

-.\" $FreeBSD: src/lib/libc/stdio/fseek.3,v 1.24 2002/12/19 09:40:24 ru Exp $
+.\" $FreeBSD: src/lib/libc/stdio/fseek.3,v 1.25 2004/03/20 08:38:27 tjr Exp $

 .\"
 .\"

-.Dd October 12, 2002
+.Dd March 19, 2004

 .Dt FSEEK 3
 .Os
 .Sh NAME
 .Dt FSEEK 3
 .Os
 .Sh NAME


@@ -149,21 +149,29 @@ The
 and
 .Fn fsetpos
 functions
 and
 .Fn fsetpos
 functions

-are alternate interfaces equivalent to
+are alternate interfaces for retrieving and setting the current position in
+the file, similar to

 .Fn ftell
 and
 .Fn ftell
 and

-.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
+.Fn fseek ,
+except that the current position is stored in an opaque object of
+type
+.Vt fpos_t
+pointed to by

 .Fa pos .
 .Fa pos .

-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.
+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 ) ,
 .Pp
 If the stream is a wide character stream (see
 .Xr fwide 3 ) ,