+2007-04-29 Bruno Haible <bruno@clisp.org>
+
+ * lib/freading.h: Improve comments.
+ * lib/fwriting.h: Likewise.
+ * tests/test-freading.c (main): Don't check freading immediately after
+ repositioning. Needed for glibc.
+
2007-04-29 Bruno Haible <bruno@clisp.org>
* lib/freading.c (freading): Trivial simplification.
writing and there is no current read operation (such as fputc).
freading and fwriting will never both be true. If STREAM supports
- both reads and writes, then both freading and fwriting might be
- false when the stream is first opened, after repositioning (such as
- fseek, fsetpos, or rewind), after read encounters EOF, or after
- fflush, depending on the underlying implementation.
+ both reads and writes, then:
+ - both freading and fwriting might be false when the stream is first
+ opened, after read encounters EOF, or after fflush,
+ - freading might be false or true and fwriting might be false
+ after repositioning (such as fseek, fsetpos, or rewind),
+ depending on the underlying implementation.
STREAM must not be wide-character oriented. */
as fputc).
freading and fwriting will never both be true. If STREAM supports
- both reads and writes, then both freading and fwriting might be
- false when the stream is first opened, after repositioning (such as
- fseek, fsetpos, or rewind), after read encounters EOF, or after
- fflush, depending on the underlying implementation.
+ both reads and writes, then:
+ - both freading and fwriting might be false when the stream is first
+ opened, after read encounters EOF, or after fflush,
+ - freading might be false or true and fwriting might be false
+ after repositioning (such as fseek, fsetpos, or rewind),
+ depending on the underlying implementation.
STREAM must not be wide-character oriented. */
ASSERT (!freading (fp));
if (fseek (fp, 0, SEEK_END))
goto skip;
- ASSERT (!freading (fp));
+ /* freading (fp) is undefined here, because on some implementations (e.g.
+ glibc) fseek causes a buffer to be read.
+ fwriting (fp) is undefined as well. */
if (fclose (fp))
goto skip;
ASSERT (!freading (fp));
if (fseek (fp, 0, SEEK_END))
goto skip;
- ASSERT (!freading (fp));
+ /* freading (fp) is undefined here, because on some implementations (e.g.
+ glibc) fseek causes a buffer to be read.
+ fwriting (fp) is undefined as well. */
if (fclose (fp))
goto skip;
ASSERT (fwriting (fp));
if (fseek (fp, 0, SEEK_END))
goto skip;
- /* fwriting (fp) is undefined here, but freading (fp) is false. */
+ /* freading (fp) is undefined here, because on some implementations (e.g.
+ glibc) fseek causes a buffer to be read.
+ fwriting (fp) is undefined as well. */
if (fclose (fp))
goto skip;
ASSERT (fwriting (fp));
if (fseek (fp, 0, SEEK_END))
goto skip;
- /* fwriting (fp) is undefined here, but freading (fp) is false. */
+ /* freading (fp) is undefined here, because on some implementations (e.g.
+ glibc) fseek causes a buffer to be read.
+ fwriting (fp) is undefined as well. */
if (fclose (fp))
goto skip;