summaryrefslogtreecommitdiff
path: root/libquadmath/libquadmath.texi
diff options
context:
space:
mode:
authorjakub <jakub@138bc75d-0d04-0410-961f-82ee72b054a4>2011-02-14 15:34:44 +0000
committerjakub <jakub@138bc75d-0d04-0410-961f-82ee72b054a4>2011-02-14 15:34:44 +0000
commit0c0fb0a6d9c870bcae9849df9cfbcf26c750759a (patch)
treea69f03ba3c677008fe5633e1a0886cffc77d95b8 /libquadmath/libquadmath.texi
parente11f718628de9d660a6721a4cd02c72e1fbbb600 (diff)
downloadgcc-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.texi56
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