diff options
author | tjr <tjr@FreeBSD.org> | 2002-10-12 09:22:25 +0000 |
---|---|---|
committer | tjr <tjr@FreeBSD.org> | 2002-10-12 09:22:25 +0000 |
commit | aaa87a36c4e0b60fe7520126c5d20e5b1ea6f0a9 (patch) | |
tree | 25491c77b8aa3e6a251185d26106072a70680a06 | |
parent | a442bb828050e9c0c620db90cfa62cc9b3e9ca2b (diff) | |
download | FreeBSD-src-aaa87a36c4e0b60fe7520126c5d20e5b1ea6f0a9.zip FreeBSD-src-aaa87a36c4e0b60fe7520126c5d20e5b1ea6f0a9.tar.gz |
Describe the restrictions on seeking on wide character streams, and also
point out that fseek() clears the ungetwc() buffer.
-rw-r--r-- | lib/libc/stdio/fseek.3 | 18 |
1 files changed, 15 insertions, 3 deletions
diff --git a/lib/libc/stdio/fseek.3 b/lib/libc/stdio/fseek.3 index 2c72532..6326751 100644 --- a/lib/libc/stdio/fseek.3 +++ b/lib/libc/stdio/fseek.3 @@ -36,7 +36,7 @@ .\" @(#)fseek.3 8.1 (Berkeley) 6/4/93 .\" $FreeBSD$ .\" -.Dd March 5, 1999 +.Dd October 12, 2002 .Dt FSEEK 3 .Os .Sh NAME @@ -92,7 +92,9 @@ A successful call to the function clears the end-of-file indicator for the stream and undoes any effects of the .Xr ungetc 3 -function on the same stream. +and +.Xr ungetwc 3 +functions on the same stream. .Pp The .Fn ftell @@ -162,6 +164,14 @@ 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. +.Pp +If the stream is a wide character stream (see +.Xr fwide 3 Ns No ), +the position specified by the combination of +.Fa offset +and +.Fa whence +must contain the first byte of a multibyte sequence. .Sh RETURN VALUES The .Fn rewind @@ -231,7 +241,9 @@ and .Sh SEE ALSO .Xr lseek 2 , .Xr clearerr 3 , -.Xr ungetc 3 +.Xr fwide 3 , +.Xr ungetc 3 , +.Xr ungetwc 3 .Sh STANDARDS The .Fn fgetpos , |