diff options
author | Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com> | 2016-11-14 14:36:18 -0200 |
---|---|---|
committer | Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com> | 2017-05-25 16:14:47 -0300 |
commit | aee0db1113e789c78377a32ca487a19c6091cda4 (patch) | |
tree | a7c05bf06822924eab9bba2546339e2b93c723fb | |
parent | 3d9c4a47798dbf95be62e1a72d9860ba0c9c2657 (diff) | |
download | glibc-aee0db1113e789c78377a32ca487a19c6091cda4.tar glibc-aee0db1113e789c78377a32ca487a19c6091cda4.tar.gz glibc-aee0db1113e789c78377a32ca487a19c6091cda4.tar.bz2 glibc-aee0db1113e789c78377a32ca487a19c6091cda4.zip |
float128: Add strfromf128, strtof128, and wcstof128 to the manual
2016-11-14 Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
* manual/arith.texi: Add descriptions for strfromf128, strtof128,
and wcstof128.
-rw-r--r-- | manual/arith.texi | 39 |
1 files changed, 33 insertions, 6 deletions
diff --git a/manual/arith.texi b/manual/arith.texi index dec12a06ae..fa1fd88668 100644 --- a/manual/arith.texi +++ b/manual/arith.texi @@ -2990,23 +2990,38 @@ double} is a separate type). These functions have been GNU extensions and are new to @w{ISO C99}. @end deftypefun +@comment stdlib.h +@comment ISO/IEC TS 18661-3 +@deftypefun _Float128 strtof128 (const char *@var{string}, char **@var{tailptr}) +@safety{@prelim{}@mtsafe{@mtslocale{}}@assafe{}@acsafe{}} +The @code{strtof128} function (``string-to-float128'') is like +@code{strtod}, except that it returns a @code{_Float128} value. + +The @code{strtof128} function was introduced in @w{ISO/IEC TS 18661-3}. +@end deftypefun + @comment wchar.h @comment ISO @deftypefun double wcstod (const wchar_t *restrict @var{string}, wchar_t **restrict @var{tailptr}) -@comment stdlib.h +@comment wchar.h @comment ISO @deftypefunx float wcstof (const wchar_t *@var{string}, wchar_t **@var{tailptr}) -@comment stdlib.h +@comment wchar.h @comment ISO @deftypefunx {long double} wcstold (const wchar_t *@var{string}, wchar_t **@var{tailptr}) +@comment wchar.h +@deftypefunx _Float128 wcstof128 (const wchar_t *@var{string}, wchar_t **@var{tailptr}) @safety{@prelim{}@mtsafe{@mtslocale{}}@assafe{}@acsafe{}} -The @code{wcstod}, @code{wcstof}, and @code{wcstol} functions are -equivalent in nearly all aspect to the @code{strtod}, @code{strtof}, and -@code{strtold} functions but it handles wide character string. +The @code{wcstod}, @code{wcstof}, @code{wcstol}, and @code{wcstof128} +functions are equivalent in nearly all aspect to the @code{strtod}, +@code{strtof}, @code{strtold}, and @code{strtof128} functions but they +handle wide character string. The @code{wcstod} function was introduced in @w{Amendment 1} of @w{ISO C90}. The @code{wcstof} and @code{wcstold} functions were introduced in -@w{ISO C99}. +@w{ISO C99}. The @code{wcstof128} function is not in any standard, but is +added to provide completeness for the non-deprecated interface of wide +character string to floating-point conversion functions. @end deftypefun @comment stdlib.h @@ -3064,6 +3079,18 @@ has been completely written if and only if the returned value is less than These functions were introduced by ISO/IEC TS 18661-1. @end deftypefun +@comment stdlib.h +@comment ISO/IEC TS 18661-3 +@deftypefun int strfromf128 (char *restrict @var{string}, size_t @var{size}, const char *restrict @var{format}, _Float128 @var{value}) +@safety{@prelim{}@mtsafe{@mtslocale{}}@asunsafe{@ascuheap{}}@acunsafe{@acsmem{}}} +@comment this function depends on __printf_fp and __printf_fphex, which are +@comment AS-unsafe (ascuheap) and AC-unsafe (acsmem). +The @code{strfromf128} function (``string-from-float128'') is like +@code{strfromd}, except that @var{value} has floating type _Float128. + +The @code{strfromf128} function was introduced by ISO/IEC TS 18661-3. +@end deftypefun + @node System V Number Conversion @section Old-fashioned System V number-to-string functions |