From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 118421 invoked by alias); 26 May 2017 12:57:30 -0000 Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org Received: (qmail 118360 invoked by uid 89); 26 May 2017 12:57:29 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-25.3 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_0,GIT_PATCH_1,GIT_PATCH_2,GIT_PATCH_3,KAM_LAZY_DOMAIN_SECURITY,RCVD_IN_DNSWL_LOW autolearn=ham version=3.3.2 spammy=old-fashioned, oldfashioned X-HELO: mx0a-001b2d01.pphosted.com From: "Gabriel F. T. Gomes" To: libc-alpha@sourceware.org Subject: [PATCH 5/6] float128: Add strfromf128, strtof128, and wcstof128 to the manual Date: Fri, 26 May 2017 12:57:00 -0000 In-Reply-To: <1495803396-14558-1-git-send-email-gftg@linux.vnet.ibm.com> References: <1495803396-14558-1-git-send-email-gftg@linux.vnet.ibm.com> X-TM-AS-MML: disable x-cbid: 17052612-0028-0000-0000-000001B89949 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 17052612-0029-0000-0000-000014B90496 Message-Id: <1495803396-14558-6-git-send-email-gftg@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:,, definitions=2017-05-26_08:,, signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 spamscore=0 suspectscore=1 malwarescore=0 phishscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1703280000 definitions=main-1705260236 X-SW-Source: 2017-05/txt/msg00799.txt.bz2 2016-11-14 Gabriel F. T. Gomes * manual/arith.texi: Add descriptions for strfromf128, strtof128, and wcstof128. --- manual/arith.texi | 39 +++++++++++++++++++++++++++++++++------ 1 file changed, 33 insertions(+), 6 deletions(-) diff --git a/manual/arith.texi b/manual/arith.texi index dec12a0..fa1fd88 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 -- 2.4.11