diff options
author | jakub <jakub@138bc75d-0d04-0410-961f-82ee72b054a4> | 2011-02-14 15:34:44 +0000 |
---|---|---|
committer | jakub <jakub@138bc75d-0d04-0410-961f-82ee72b054a4> | 2011-02-14 15:34:44 +0000 |
commit | 0c0fb0a6d9c870bcae9849df9cfbcf26c750759a (patch) | |
tree | a69f03ba3c677008fe5633e1a0886cffc77d95b8 /libquadmath/libquadmath.texi | |
parent | e11f718628de9d660a6721a4cd02c72e1fbbb600 (diff) | |
download | gcc-0c0fb0a6d9c870bcae9849df9cfbcf26c750759a.tar.gz |
PR fortran/47642
* libquadmath.texi (quadmath_snprintf): Document.
(quadmath_flt128tostr): Remove.
* Makefile.am (libquadmath_la_SOURCES): Add printf/*.c.
Remove quadmath_io.c, gdtoa/gdtoa.c, gdtoa/g__fmt.c,
gdtoa/g_Qfmt.c, gdtoa/dmisc.c and gdtoa/ulp.c.
* quadmath.h (quadmath_snprintf): New prototype.
(quadmath_flt128tostr): Remove.
* quadmath_weak.h (quadmath_snprintf): Add.
(quadmath_flt128tostr): Remove.
* configure.ac: New AC_CHECK_HEADERS headers: langinfo.h, wchar.h,
wctype.h, limits.h, ctype.h, printf.h, errno.h.
(AC_USE_SYSTEM_EXTENSIONS): Add.
(HAVE_HIDDEN_VISIBILITY, HAVE_PRINTF_HOOKS,
USE_LOCALE_SUPPORT, USE_I18N_NUMBER_H): New checks.
* quadmath.map (QUADMATH_1.0): Add quadmath_snprintf. Remove
quadmath_flt128tostr.
* printf/printf_fphex.c: New file.
* printf/_itowa.h: New file.
* printf/mul_n.c: New file.
* printf/quadmath-printf.h: New file.
* printf/submul_1.c: New file.
* printf/quadmath-printf.c: New file.
* printf/gmp-impl.h: New file.
* printf/lshift.c: New file.
* printf/fpioconst.h: New file.
* printf/add_n.c: New file.
* printf/cmp.c: New file.
* printf/sub_n.c: New file.
* printf/mul.c: New file.
* printf/divrem.c: New file.
* printf/addmul_1.c: New file.
* printf/printf_fp.c: New file.
* printf/_itoa.h: New file.
* printf/fpioconst.c: New file.
* printf/_i18n_number.h: New file.
* printf/flt1282mpn.c: New file.
* printf/rshift.c: New file.
* printf/mul_1.c: New file.
* quadmath_io.c: Removed.
* gdtoa/gdtoa.c: Removed.
* gdtoa/g__fmt.c: Removed.
* gdtoa/g_Qfmt.c: Removed.
* gdtoa/dmisc.c: Removed.
* gdtoa/ulp.c: Removed.
* config.h.in: Regenerated.
* configure: Regenerated.
* Makefile.in: Regenerated.
* io/write_float.def (DTOAQ): Use quadmath_snprintf instead of
quadmath_flt128tostr.
* io/transfer128.c (tmp2): Initialize to quadmath_snprintf instead
of quadmath_flt128tostr.
git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@170135 138bc75d-0d04-0410-961f-82ee72b054a4
Diffstat (limited to 'libquadmath/libquadmath.texi')
-rw-r--r-- | libquadmath/libquadmath.texi | 56 |
1 files changed, 43 insertions, 13 deletions
diff --git a/libquadmath/libquadmath.texi b/libquadmath/libquadmath.texi index bcd205939d9..f361ea934f3 100644 --- a/libquadmath/libquadmath.texi +++ b/libquadmath/libquadmath.texi @@ -246,7 +246,7 @@ The following mathematical functions are available: @menu * @code{strtoflt128}: strtoflt128, Convert from string -* @code{quadmath_flt128tostr}: quadmath_flt128tostr, Convert to string +* @code{quadmath_snprintf}: quadmath_snprintf, Convert to string @end menu @@ -289,43 +289,73 @@ int main () @end table -@node quadmath_flt128tostr -@section @code{quadmath_flt128tostr} --- Convert to string +@node quadmath_snprintf +@section @code{quadmath_snprintf} --- Convert to string -The function @code{quadmath_flt128tostr} converts a @code{__float128} floating-point -number into a string. +The function @code{quadmath_snprintf} converts a @code{__float128} floating-point +number into a string. It is a specialized alternative to @code{snprintf}, where +the format string is restricted to a single conversion specifier with @code{Q} +modifier and conversion specifier @code{e}, @code{E}, @code{f}, @code{F}, @code{g}, +@code{G}, @code{a} or @code{A}, with no extra characters before or after the +conversion specifier. The @code{%m$} or @code{*m$} style must not be used in +the format. @table @asis @item Syntax -@code{void quadmath_flt128tostr (char *s, size_t size, size_t n, __float128 x)} +@code{int quadmath_snprintf (char *s, size_t size, const char *format, ...)} @item @emph{Arguments}: @multitable @columnfractions .15 .70 @item @var{s} @tab output string @item @var{size} @tab byte size of the string, including tailing NUL -@item @var{n} @tab number of digits after the decimal point -@item @var{x} @tab the number to be converted +@item @var{format} @tab conversion specifier string @end multitable @item Example @smallexample #include <quadmath.h> +#include <stdlib.h> +#include <stdio.h> int main () @{ __float128 r; - char str[200]; + int prec = 20; + int width = 46; + char buf[128]; r = 2.0q; - r = sqrtq(r); - quadmath_flt128tostr (str, sizeof (str), 20, r); - printf("%s\n", str); - /* Prints: +1.41421356237309504880e+00 */ + r = sqrtq (r); + int n = quadmath_snprintf (buf, sizeof buf, "%+-#*.20Qe", width, r); + if ((size_t) n < sizeof buf) + printf ("%s\n", buf); + /* Prints: +1.41421356237309504880e+00 */ + quadmath_snprintf (buf, sizeof buf, "%Qa", r); + if ((size_t) n < sizeof buf) + printf ("%s\n", buf); + /* Prints: 0x1.6a09e667f3bcc908b2fb1366ea96p+0 */ + n = quadmath_snprintf (NULL, 0, "%+-#46.*Qe", prec, r); + if (n > -1) + @{ + char *str = malloc (n + 1); + if (str) + @{ + quadmath_snprintf (str, n + 1, "%+-#46.*Qe", prec, r); + printf ("%s\n", str); + /* Prints: +1.41421356237309504880e+00 */ + @} + free (str); + @} return 0; @} @end smallexample + @end table +On some targets when supported by the C library hooks are installed +for @code{printf} family of functions, so that @code{printf ("%Qe", 1.2Q);} +etc.@: works too. + @c --------------------------------------------------------------------- @c GNU Free Documentation License |