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

• Show log

  Commit

• Hash : bd38edc8
  Author :
  Date : 2015-02-20T18:09:47
  

  printf, isinf, etc.: noncanonical != NaN
  
  Do not require that isinf, printf, etc. treat noncanonical
  values as NaNs.  Instead, require only that they do not crash.
  Problem reported by Joseph Myers in:
  https://sourceware.org/ml/libc-alpha/2015-02/msg00244.html
  * doc/posix-functions/dprintf.texi (dprintf):
  * doc/posix-functions/fprintf.texi (fprintf):
  * doc/posix-functions/isfinite.texi (isfinite):
  * doc/posix-functions/isinf.texi (isinf):
  * doc/posix-functions/isnan.texi (isnan):
  * doc/posix-functions/printf.texi (printf):
  * doc/posix-functions/snprintf.texi (snprintf):
  * doc/posix-functions/sprintf.texi (sprintf):
  * doc/posix-functions/vdprintf.texi (vdprintf):
  * doc/posix-functions/vfprintf.texi (vfprintf):
  * doc/posix-functions/vprintf.texi (vprintf):
  * doc/posix-functions/vsnprintf.texi (vsnprintf):
  * doc/posix-functions/vsprintf.texi (vsprintf):
  Document this.
  * m4/isfinite.m4 (gl_ISFINITEL_WORKS):
  * m4/isinf.m4 (gl_ISINFL_WORKS):
  * m4/isnanl.m4 (gl_FUNC_ISNANL_WORKS):
  * m4/printf.m4 (gl_PRINTF_INFINITE_LONG_DOUBLE):
  * tests/test-isfinite.c (test_isfinitel):
  * tests/test-isinf.c (test_isinfl):
  * tests/test-isnan.c (test_long_double):
  * tests/test-isnanl.h (main):
  * tests/test-snprintf-posix.h (test_function):
  * tests/test-sprintf-posix.h (test_function):
  * tests/test-vasnprintf-posix.c (test_function):
  * tests/test-vasprintf-posix.c (test_function):
  o	Test only that noncanonical values do not cause crashes, not that
  they are treated as NaNs.  In some cases this means a larger
  output buffer is needed.
  

Download

• doc/posix-functions/dprintf.texi

• @node dprintf
  @section @code{dprintf}
  @findex dprintf
  
  POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/dprintf.html}
  
  Gnulib module: dprintf or dprintf-posix
  
  Portability problems fixed by either Gnulib module @code{dprintf} or @code{dprintf-posix}:
  @itemize
  @item
  This function is missing on many non-glibc platforms:
  Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, HP-UX 11,
  IRIX 6.5, OSF/1 5.1, Solaris 11 2011-11, Cygwin 1.5.x, mingw, MSVC 9, Interix 3.5, BeOS.
  @end itemize
  
  Portability problems fixed by Gnulib module @code{dprintf-posix}:
  @itemize
  @item
  This function does not support the @samp{a} and @samp{A} directives on some
  platforms:
  glibc-2.3.6.
  @item
  This function does not support precisions larger than 512 or 1024 in integer,
  floating-point and pointer output on some platforms:
  AIX 7.1.
  @end itemize
  
  Portability problems not fixed by Gnulib:
  @itemize
  @item
  Formatting noncanonical @samp{long double} numbers produces
  nonmeaningful results on some platforms:
  glibc and others, on x86, x86_64, IA-64 CPUs.
  @item
  When formatting an integer with grouping flag, this function inserts thousands
  separators even in the "C" locale on some platforms:
  NetBSD 5.1.
  @item
  On some platforms, this function does not set @code{errno} or the
  stream error indicator on attempts to write to a read-only stream:
  Cygwin 1.7.9.
  @end itemize
  

Download