kc3-lang/gnulib/doc/posix-functions/ftello.texi

• Show log

  Commit

• Hash : c254399a
  Author :
  Date : 2023-04-24T19:48:47
  

  ftell, ftello: Fix recognition of pipes on native Windows.
  
  * m4/lseek.m4 (gl_FUNC_LSEEK): Update comment.
  * m4/ftello.m4 (gl_FUNC_FTELLO): On native Windows, set REPLACE_FTELLO=1
  always.
  * doc/posix-functions/ftello.texi: Mention the behaviour on pipes.
  * doc/posix-functions/ftell.texi: Likewise.
  * doc/posix-functions/fgetpos.texi: Likewise.
  

Download

• doc/posix-functions/ftello.texi

• @node ftello
  @section @code{ftello}
  @findex ftello
  
  POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/ftello.html}
  
  Gnulib module: ftello
  
  Portability problems fixed by Gnulib:
  @itemize
  @item
  This function is missing on some platforms:
  mingw, MSVC 14.
  @item
  The declaration of @code{ftello} in @code{<stdio.h>} is not enabled by default
  on some platforms:
  glibc 2.3.6.
  @item
  This function produces incorrect results after @code{putc} that followed a
  @code{getc} call that reached EOF on some platforms:
  Solaris 11 2010-11.
  @item
  This function, when invoked after @code{ungetc}, throws away the @code{ungetc}
  buffer, changes the stream's file position, and returns the wrong position on
  some platforms:
  macOS 10.15 and newer.
  @item
  This function fails on seekable stdin, stdout, and stderr: cygwin <= 1.5.24.
  @item
  This function mistakenly succeeds on pipes on some platforms:
  mingw 10.
  @item
  On platforms where @code{off_t} is a 32-bit type, @code{ftello} does not work
  correctly with files 2 GiB and larger.  @xref{Large File Support}.
  @end itemize
  
  Portability problems not fixed by Gnulib:
  @itemize
  @item
  This function produces incorrect results immediately after @code{fseek} on some
  platforms:
  HP-UX 11.
  @item
  @code{fflush}, @code{ftell}, @code{ftello}, @code{fgetpos} behave incorrectly
  on input streams that are opened in @code{O_TEXT} mode and whose contents
  contains Unix line terminators (LF), on some platforms: mingw, MSVC 14.
  @end itemize
  

Download