head 1.1; branch 1.1.1; access; symbols netbsd-11-0-RC6:1.1.1.3 netbsd-11-0-RC5:1.1.1.3 netbsd-11-0-RC4:1.1.1.3 netbsd-11-0-RC3:1.1.1.3 netbsd-11-0-RC2:1.1.1.3 netbsd-11-0-RC1:1.1.1.3 gcc-14-3-0:1.1.1.4 perseant-exfatfs-base-20250801:1.1.1.3 netbsd-11:1.1.1.3.0.4 netbsd-11-base:1.1.1.3 gcc-12-5-0:1.1.1.3 netbsd-10-1-RELEASE:1.1.1.2 perseant-exfatfs-base-20240630:1.1.1.3 gcc-12-4-0:1.1.1.3 perseant-exfatfs:1.1.1.3.0.2 perseant-exfatfs-base:1.1.1.3 netbsd-10-0-RELEASE:1.1.1.2 netbsd-10-0-RC6:1.1.1.2 netbsd-10-0-RC5:1.1.1.2 netbsd-10-0-RC4:1.1.1.2 netbsd-10-0-RC3:1.1.1.2 netbsd-10-0-RC2:1.1.1.2 netbsd-10-0-RC1:1.1.1.2 gcc-12-3-0:1.1.1.3 gcc-10-5-0:1.1.1.2 netbsd-10:1.1.1.2.0.6 netbsd-10-base:1.1.1.2 gcc-10-4-0:1.1.1.2 cjep_sun2x-base1:1.1.1.2 cjep_sun2x:1.1.1.2.0.4 cjep_sun2x-base:1.1.1.2 cjep_staticlib_x-base1:1.1.1.2 cjep_staticlib_x:1.1.1.2.0.2 cjep_staticlib_x-base:1.1.1.2 gcc-10-3-0:1.1.1.2 gcc-9-3-0:1.1.1.1 FSF:1.1.1; locks; strict; comment @# @; 1.1 date 2020.09.05.07.52.02; author mrg; state Exp; branches 1.1.1.1; next ; commitid ZRYA7IOuwfMjAPmC; 1.1.1.1 date 2020.09.05.07.52.02; author mrg; state Exp; branches; next 1.1.1.2; commitid ZRYA7IOuwfMjAPmC; 1.1.1.2 date 2021.04.10.22.10.15; author mrg; state Exp; branches; next 1.1.1.3; commitid eC4g0MRpqTvEkNOC; 1.1.1.3 date 2023.07.30.05.21.30; author mrg; state Exp; branches; next 1.1.1.4; commitid tk6nV4mbc9nVEMyE; 1.1.1.4 date 2025.09.13.23.46.00; author mrg; state Exp; branches; next ; commitid KwhwN4krNWa6XBaG; desc @@ 1.1 log @Initial revision @ text @\input texinfo @@c -*-texinfo-*- @@c %**start of header @@setfilename libquadmath.info @@settitle GCC libquadmath @@c %**end of header @@copying Copyright @@copyright{} 2010-2019 Free Software Foundation, Inc. @@quotation Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, with the Front-Cover Texts being ``A GNU Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the license is included in the section entitled ``GNU Free Documentation License.'' (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and modify this GNU manual. @@end quotation @@end copying @@ifinfo @@dircategory GNU Libraries @@direntry * libquadmath: (libquadmath). GCC Quad-Precision Math Library @@end direntry This manual documents the GCC Quad-Precision Math Library API. Published by the Free Software Foundation 51 Franklin Street, Fifth Floor Boston, MA 02110-1301 USA @@insertcopying @@end ifinfo @@setchapternewpage odd @@titlepage @@title The GCC Quad-Precision Math Library @@page @@vskip 0pt plus 1filll @@comment For the @@value{version-GCC} Version* @@sp 1 Published by the Free Software Foundation @@* 51 Franklin Street, Fifth Floor@@* Boston, MA 02110-1301, USA@@* @@sp 1 @@insertcopying @@end titlepage @@summarycontents @@contents @@page @@node Top @@top Introduction @@cindex Introduction This manual documents the usage of libquadmath, the GCC Quad-Precision Math Library Application Programming Interface (API). @@comment @@comment When you add a new menu item, please keep the right hand @@comment aligned to the same column. Do not use tabs. This provides @@comment better formatting. @@comment @@menu * Typedef and constants:: Defined data types and constants * Math Library Routines:: The Libquadmath math runtime application programming interface. * I/O Library Routines:: The Libquadmath I/O runtime application programming interface. * GNU Free Documentation License:: How you can copy and share this manual. * Reporting Bugs:: How to report bugs in GCC Libquadmath. @@c * Index:: Index of this documentation. @@end menu @@c --------------------------------------------------------------------- @@c Defined macros @@c --------------------------------------------------------------------- @@node Typedef and constants @@chapter Typedef and constants The following data type has been defined via @@code{typedef}. @@table @@asis @@item @@code{__complex128}: @@code{__float128}-based complex number @@end table The following macros are defined, which give the numeric limits of the @@code{__float128} data type. @@table @@asis @@item @@code{FLT128_MAX}: largest finite number @@item @@code{FLT128_MIN}: smallest positive number with full precision @@item @@code{FLT128_EPSILON}: difference between 1 and the next larger representable number @@item @@code{FLT128_DENORM_MIN}: smallest positive denormalized number @@item @@code{FLT128_MANT_DIG}: number of digits in the mantissa (bit precision) @@item @@code{FLT128_MIN_EXP}: maximal negative exponent @@item @@code{FLT128_MAX_EXP}: maximal positive exponent @@item @@code{FLT128_DIG}: number of decimal digits in the mantissa @@item @@code{FLT128_MIN_10_EXP}: maximal negative decimal exponent @@item @@code{FLT128_MAX_10_EXP}: maximal positive decimal exponent @@end table The following mathematical constants of type @@code{__float128} are defined. @@table @@asis @@item @@code{M_Eq}: the constant e (Euler's number) @@item @@code{M_LOG2Eq}: binary logarithm of 2 @@item @@code{M_LOG10Eq}: common, decimal logarithm of 2 @@item @@code{M_LN2q}: natural logarithm of 2 @@item @@code{M_LN10q}: natural logarithm of 10 @@item @@code{M_PIq}: pi @@item @@code{M_PI_2q}: pi divided by two @@item @@code{M_PI_4q}: pi divided by four @@item @@code{M_1_PIq}: one over pi @@item @@code{M_2_PIq}: one over two pi @@item @@code{M_2_SQRTPIq}: two over square root of pi @@item @@code{M_SQRT2q}: square root of 2 @@item @@code{M_SQRT1_2q}: one over square root of 2 @@end table @@c --------------------------------------------------------------------- @@c Math routines @@c --------------------------------------------------------------------- @@node Math Library Routines @@chapter Math Library Routines The following mathematical functions are available: @@table @@asis @@item @@code{acosq}: arc cosine function @@item @@code{acoshq}: inverse hyperbolic cosine function @@item @@code{asinq}: arc sine function @@item @@code{asinhq}: inverse hyperbolic sine function @@item @@code{atanq}: arc tangent function @@item @@code{atanhq}: inverse hyperbolic tangent function @@item @@code{atan2q}: arc tangent function @@item @@code{cbrtq}: cube root function @@item @@code{ceilq}: ceiling value function @@item @@code{copysignq}: copy sign of a number @@item @@code{coshq}: hyperbolic cosine function @@item @@code{cosq}: cosine function @@item @@code{erfq}: error function @@item @@code{erfcq}: complementary error function @@item @@code{exp2q}: base 2 exponential function @@item @@code{expq}: exponential function @@item @@code{expm1q}: exponential minus 1 function @@need 800 @@item @@code{fabsq}: absolute value function @@item @@code{fdimq}: positive difference function @@item @@code{finiteq}: check finiteness of value @@item @@code{floorq}: floor value function @@item @@code{fmaq}: fused multiply and add @@item @@code{fmaxq}: determine maximum of two values @@item @@code{fminq}: determine minimum of two values @@item @@code{fmodq}: remainder value function @@item @@code{frexpq}: extract mantissa and exponent @@item @@code{hypotq}: Eucledian distance function @@item @@code{ilogbq}: get exponent of the value @@item @@code{isinfq}: check for infinity @@item @@code{isnanq}: check for not a number @@item @@code{issignalingq}: check for signaling not a number @@item @@code{j0q}: Bessel function of the first kind, first order @@item @@code{j1q}: Bessel function of the first kind, second order @@item @@code{jnq}: Bessel function of the first kind, @@var{n}-th order @@item @@code{ldexpq}: load exponent of the value @@item @@code{lgammaq}: logarithmic gamma function @@item @@code{llrintq}: round to nearest integer value @@item @@code{llroundq}: round to nearest integer value away from zero @@item @@code{logbq}: get exponent of the value @@item @@code{logq}: natural logarithm function @@item @@code{log10q}: base 10 logarithm function @@item @@code{log1pq}: compute natural logarithm of the value plus one @@item @@code{log2q}: base 2 logarithm function @@need 800 @@item @@code{lrintq}: round to nearest integer value @@item @@code{lroundq}: round to nearest integer value away from zero @@item @@code{modfq}: decompose the floating-point number @@item @@code{nanq}: return quiet NaN @@item @@code{nearbyintq}: round to nearest integer @@item @@code{nextafterq}: next representable floating-point number @@item @@code{powq}: power function @@item @@code{remainderq}: remainder function @@item @@code{remquoq}: remainder and part of quotient @@item @@code{rintq}: round-to-nearest integral value @@item @@code{roundq}: round-to-nearest integral value, return @@code{__float128} @@item @@code{scalblnq}: compute exponent using @@code{FLT_RADIX} @@item @@code{scalbnq}: compute exponent using @@code{FLT_RADIX} @@item @@code{signbitq}: return sign bit @@item @@code{sincosq}: calculate sine and cosine simultaneously @@item @@code{sinhq}: hyperbolic sine function @@item @@code{sinq}: sine function @@item @@code{sqrtq}: square root function @@item @@code{tanq}: tangent function @@item @@code{tanhq}: hyperbolic tangent function @@need 800 @@item @@code{tgammaq}: true gamma function @@item @@code{truncq}: round to integer, towards zero @@item @@code{y0q}: Bessel function of the second kind, first order @@item @@code{y1q}: Bessel function of the second kind, second order @@item @@code{ynq}: Bessel function of the second kind, @@var{n}-th order @@item @@code{cabsq} complex absolute value function @@item @@code{cargq}: calculate the argument @@item @@code{cimagq} imaginary part of complex number @@item @@code{crealq}: real part of complex number @@item @@code{cacoshq}: complex arc hyperbolic cosine function @@item @@code{cacosq}: complex arc cosine function @@item @@code{casinhq}: complex arc hyperbolic sine function @@item @@code{casinq}: complex arc sine function @@item @@code{catanhq}: complex arc hyperbolic tangent function @@item @@code{catanq}: complex arc tangent function @@item @@code{ccosq} complex cosine function: @@item @@code{ccoshq}: complex hyperbolic cosine function @@item @@code{cexpq}: complex exponential function @@need 800 @@item @@code{cexpiq}: computes the exponential function of ``i'' times a real value @@item @@code{clogq}: complex natural logarithm @@item @@code{clog10q}: complex base 10 logarithm @@item @@code{conjq}: complex conjugate function @@item @@code{cpowq}: complex power function @@item @@code{cprojq}: project into Riemann Sphere @@item @@code{csinq}: complex sine function @@item @@code{csinhq}: complex hyperbolic sine function @@item @@code{csqrtq}: complex square root @@item @@code{ctanq}: complex tangent function @@item @@code{ctanhq}: complex hyperbolic tangent function @@end table @@c --------------------------------------------------------------------- @@c I/O routines @@c --------------------------------------------------------------------- @@node I/O Library Routines @@chapter I/O Library Routines @@menu * @@code{strtoflt128}: strtoflt128, Convert from string * @@code{quadmath_snprintf}: quadmath_snprintf, Convert to string @@end menu @@node strtoflt128 @@section @@code{strtoflt128} --- Convert from string The function @@code{strtoflt128} converts a string into a @@code{__float128} number. @@table @@asis @@item Syntax @@code{__float128 strtoflt128 (const char *s, char **sp)} @@item @@emph{Arguments}: @@multitable @@columnfractions .15 .70 @@item @@var{s} @@tab input string @@item @@var{sp} @@tab the address of the next character in the string @@end multitable The argument @@var{sp} contains, if not @@code{NULL}, the address of the next character following the parts of the string, which have been read. @@item Example @@smallexample #include int main () @@{ __float128 r; r = strtoflt128 ("1.2345678", NULL); return 0; @@} @@end smallexample @@end table @@node quadmath_snprintf @@section @@code{quadmath_snprintf} --- Convert to 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{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{format} @@tab conversion specifier string @@end multitable @@item Note 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. @@item Example @@smallexample #include #include #include int main () @@{ __float128 r; int prec = 20; int width = 46; char buf[128]; r = 2.0q; 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 @@c --------------------------------------------------------------------- @@c GNU Free Documentation License @@c --------------------------------------------------------------------- @@include fdl.texi @@c --------------------------------------------------------------------- @@c Reporting Bugs @@c --------------------------------------------------------------------- @@c For BUGURL @@include libquadmath-vers.texi @@node Reporting Bugs @@chapter Reporting Bugs Bugs in the GCC Quad-Precision Math Library implementation should be reported via @@value{BUGURL}. @@c --------------------------------------------------------------------- @@c Index @@c --------------------------------------------------------------------- @@c @@node Index @@c @@unnumbered Index @@c @@c @@printindex cp @@bye @ 1.1.1.1 log @initial import of GCC 9.3.0. changes include: - live patching support - shell completion help - generally better diagnostic output (less verbose/more useful) - diagnostics and optimisation choices can be emitted in json - asan memory usage reduction - many general, and specific to switch, inter-procedure, profile and link-time optimisations. from the release notes: "Overall compile time of Firefox 66 and LibreOffice 6.2.3 on an 8-core machine was reduced by about 5% compared to GCC 8.3" - OpenMP 5.0 support - better spell-guesser - partial experimental support for c2x and c++2a - c++17 is no longer experimental - arm AAPCS GCC 6-8 structure passing bug fixed, may cause incompatibility (restored compat with GCC 5 and earlier.) - openrisc support @ text @@ 1.1.1.2 log @initial import of GCC 10.3.0. main changes include: caveats: - ABI issue between c++14 and c++17 fixed - profile mode is removed from libstdc++ - -fno-common is now the default new features: - new flags -fallocation-dce, -fprofile-partial-training, -fprofile-reproducible, -fprofile-prefix-path, and -fanalyzer - many new compile and link time optimisations - enhanced drive optimisations - openacc 2.6 support - openmp 5.0 features - new warnings: -Wstring-compare and -Wzero-length-bounds - extended warnings: -Warray-bounds, -Wformat-overflow, -Wrestrict, -Wreturn-local-addr, -Wstringop-overflow, -Warith-conversion, -Wmismatched-tags, and -Wredundant-tags - some likely C2X features implemented - more C++20 implemented - many new arm & intel CPUs known hundreds of reported bugs are fixed. full list of changes can be found at: https://gcc.gnu.org/gcc-10/changes.html @ text @d9 1 a9 1 Copyright @@copyright{} 2010-2020 Free Software Foundation, Inc. @ 1.1.1.3 log @initial import of GCC 12.3.0. major changes in GCC 11 included: - The default mode for C++ is now -std=gnu++17 instead of -std=gnu++14. - When building GCC itself, the host compiler must now support C++11, rather than C++98. - Some short options of the gcov tool have been renamed: -i to -j and -j to -H. - ThreadSanitizer improvements. - Introduce Hardware-assisted AddressSanitizer support. - For targets that produce DWARF debugging information GCC now defaults to DWARF version 5. This can produce up to 25% more compact debug information compared to earlier versions. - Many optimisations. - The existing malloc attribute has been extended so that it can be used to identify allocator/deallocator API pairs. A pair of new -Wmismatched-dealloc and -Wmismatched-new-delete warnings are added. - Other new warnings: -Wsizeof-array-div, enabled by -Wall, warns about divisions of two sizeof operators when the first one is applied to an array and the divisor does not equal the size of the array element. -Wstringop-overread, enabled by default, warns about calls to string functions reading past the end of the arrays passed to them as arguments. -Wtsan, enabled by default, warns about unsupported features in ThreadSanitizer (currently std::atomic_thread_fence). - Enchanced warnings: -Wfree-nonheap-object detects many more instances of calls to deallocation functions with pointers not returned from a dynamic memory allocation function. -Wmaybe-uninitialized diagnoses passing pointers or references to uninitialized memory to functions taking const-qualified arguments. -Wuninitialized detects reads from uninitialized dynamically allocated memory. -Warray-parameter warns about functions with inconsistent array forms. -Wvla-parameter warns about functions with inconsistent VLA forms. - Several new features from the upcoming C2X revision of the ISO C standard are supported with -std=c2x and -std=gnu2x. - Several C++20 features have been implemented. - The C++ front end has experimental support for some of the upcoming C++23 draft. - Several new C++ warnings. - Enhanced Arm, AArch64, x86, and RISC-V CPU support. - The implementation of how program state is tracked within -fanalyzer has been completely rewritten with many enhancements. see https://gcc.gnu.org/gcc-11/changes.html for a full list. major changes in GCC 12 include: - An ABI incompatibility between C and C++ when passing or returning by value certain aggregates containing zero width bit-fields has been discovered on various targets. x86-64, ARM and AArch64 will always ignore them (so there is a C ABI incompatibility between GCC 11 and earlier with GCC 12 or later), PowerPC64 ELFv2 always take them into account (so there is a C++ ABI incompatibility, GCC 4.4 and earlier compatible with GCC 12 or later, incompatible with GCC 4.5 through GCC 11). RISC-V has changed the handling of these already starting with GCC 10. As the ABI requires, MIPS takes them into account handling function return values so there is a C++ ABI incompatibility with GCC 4.5 through 11. - STABS: Support for emitting the STABS debugging format is deprecated and will be removed in the next release. All ports now default to emit DWARF (version 2 or later) debugging info or are obsoleted. - Vectorization is enabled at -O2 which is now equivalent to the original -O2 -ftree-vectorize -fvect-cost-model=very-cheap. - GCC now supports the ShadowCallStack sanitizer. - Support for __builtin_shufflevector compatible with the clang language extension was added. - Support for attribute unavailable was added. - Support for __builtin_dynamic_object_size compatible with the clang language extension was added. - New warnings: -Wbidi-chars warns about potentially misleading UTF-8 bidirectional control characters. -Warray-compare warns about comparisons between two operands of array type. - Some new features from the upcoming C2X revision of the ISO C standard are supported with -std=c2x and -std=gnu2x. - Several C++23 features have been implemented. - Many C++ enhancements across warnings and -f options. see https://gcc.gnu.org/gcc-12/changes.html for a full list. @ text @d9 1 a9 1 Copyright @@copyright{} 2010-2022 Free Software Foundation, Inc. d312 1 a312 1 @@item @@var{size} @@tab byte size of the string, including trailing NUL @ 1.1.1.4 log @initial import of GCC 14.3.0. major changes in GCC 13: - improved sanitizer - zstd debug info compression - LTO improvements - SARIF based diagnostic support - new warnings: -Wxor-used-as-pow, -Wenum-int-mismatch, -Wself-move, -Wdangling-reference - many new -Wanalyzer* specific warnings - enhanced warnings: -Wpessimizing-move, -Wredundant-move - new attributes to mark file descriptors, c++23 "assume" - several C23 features added - several C++23 features added - many new features for Arm, x86, RISC-V major changes in GCC 14: - more strict C99 or newer support - ia64* marked deprecated (but seemingly still in GCC 15.) - several new hardening features - support for "hardbool", which can have user supplied values of true/false - explicit support for stack scrubbing upon function exit - better auto-vectorisation support - added clang-compatible __has_feature and __has_extension - more C23, including -std=c23 - several C++26 features added - better diagnostics in C++ templates - new warnings: -Wnrvo, Welaborated-enum-base - many new features for Arm, x86, RISC-V - possible ABI breaking change for SPARC64 and small structures with arrays of floats. @ text @d9 1 a9 1 Copyright @@copyright{} 2010-2024 Free Software Foundation, Inc. @