c_cpp/lib/gnulib/doc/posix-functions/fflush.texi

   1 @node fflush
   2 @section @code{fflush}
   3 @findex fflush
   4
   5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/fflush.html}
   6
   7 Gnulib module: fflush
   8
   9 Portability problems fixed by Gnulib:
  10 @itemize
  11 @item
  12 @code{fflush} followed by @code{fseek} or @code{fseeko}, applied to an input
  13 stream, should have the effect of positioning the underlying file descriptor.
  14 It doesn't do this on some platforms.
  15 @item
  16 @code{fflush} on an input stream changes the position of the stream to the
  17 end of the previous buffer, on some platforms: mingw, MSVC 9.
  18 @item
  19 @code{fflush} on an input stream right after @code{ungetc} does not discard
  20 the @code{ungetc} buffer, on some platforms:
  21 Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Cygwin 1.5.25-10.
  22 @end itemize
  23
  24 Portability problems not fixed by Gnulib:
  25 @itemize
  26 @item
  27 @code{fflush}, @code{ftell}, @code{ftello}, @code{fgetpos} behave incorrectly
  28 on input streams that are opened in @code{O_TEXT} mode and whose contents
  29 contains Unix line terminators (LF), on some platforms: mingw, MSVC 9.
  30 @item
  31 On Windows platforms (excluding Cygwin), this function does not set @code{errno}
  32 upon failure.
  33 @item
  34 This function crashes if the stream's file descriptor has already been
  35 closed, if @code{MSVC_INVALID_PARAMETER_HANDLING} is
  36 @code{HAIRY_LIBRARY_HANDLING} or @code{SANE_LIBRARY_HANDLING},
  37 on some platforms:
  38 MSVC 9.
  39 @item
  40 @code{fflush} on an input stream right after @code{ungetc} does not discard
  41 the @code{ungetc} buffer, on some platforms:
  42 AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, mingw, MSVC 9.
  43 @end itemize