]>
Commit | Line | Data |
---|---|---|
a1eaacb1 | 1 | '\" t |
fea681da MK |
2 | .\" Copyright (C) 2002 Andries Brouwer <aeb@cwi.nl> |
3 | .\" | |
5fbde956 | 4 | .\" SPDX-License-Identifier: Linux-man-pages-copyleft |
fea681da MK |
5 | .\" |
6 | .\" This replaces an earlier man page written by Walter Harms | |
7 | .\" <walter.harms@informatik.uni-oldenburg.de>. | |
8 | .\" | |
9 | .\" Corrected return types; from Fabian; 2004-10-05 | |
10 | .\" | |
4c1c5274 | 11 | .TH ecvt_r 3 (date) "Linux man-pages (unreleased)" |
fea681da MK |
12 | .SH NAME |
13 | ecvt_r, fcvt_r, qecvt_r, qfcvt_r \- convert a floating-point number to a string | |
b813014f AC |
14 | .SH LIBRARY |
15 | Standard C library | |
16 | .RI ( libc ", " \-lc ) | |
fea681da | 17 | .SH SYNOPSIS |
b9f02710 | 18 | .nf |
fea681da | 19 | .B #include <stdlib.h> |
c6d039a3 | 20 | .P |
59a607c1 AC |
21 | .BI "[[deprecated]] int ecvt_r(double " number ", int " ndigits , |
22 | .BI " int *restrict " decpt ", int *restrict " sign , | |
23 | .BI " char *restrict " buf ", size_t " len ); | |
24 | .BI "[[deprecated]] int fcvt_r(double " number ", int " ndigits , | |
25 | .BI " int *restrict " decpt ", int *restrict " sign , | |
26 | .BI " char *restrict " buf ", size_t " len ); | |
c6d039a3 | 27 | .P |
59a607c1 AC |
28 | .BI "[[deprecated]] int qecvt_r(long double " number ", int " ndigits , |
29 | .BI " int *restrict " decpt ", int *restrict " sign , | |
30 | .BI " char *restrict " buf ", size_t " len ); | |
31 | .BI "[[deprecated]] int qfcvt_r(long double " number ", int " ndigits , | |
32 | .BI " int *restrict " decpt ", int *restrict " sign , | |
33 | .BI " char *restrict " buf ", size_t " len ); | |
b9f02710 | 34 | .fi |
c6d039a3 | 35 | .P |
d39ad78f | 36 | .RS -4 |
cc4615cc MK |
37 | Feature Test Macro Requirements for glibc (see |
38 | .BR feature_test_macros (7)): | |
d39ad78f | 39 | .RE |
c6d039a3 | 40 | .P |
cc4615cc MK |
41 | .BR ecvt_r (), |
42 | .BR fcvt_r (), | |
43 | .BR qecvt_r (), | |
44 | .BR qfcvt_r (): | |
9d2adbae | 45 | .nf |
75c018a1 AC |
46 | /* glibc >= 2.19: */ _DEFAULT_SOURCE |
47 | || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE | |
9d2adbae | 48 | .fi |
fea681da MK |
49 | .SH DESCRIPTION |
50 | The functions | |
e511ffb6 MK |
51 | .BR ecvt_r (), |
52 | .BR fcvt_r (), | |
9af134cd | 53 | .BR qecvt_r (), |
fea681da | 54 | and |
e511ffb6 | 55 | .BR qfcvt_r () |
fea681da | 56 | are identical to |
7a056410 MK |
57 | .BR ecvt (3), |
58 | .BR fcvt (3), | |
9af134cd | 59 | .BR qecvt (3), |
fea681da | 60 | and |
7a056410 | 61 | .BR qfcvt (3), |
fea681da MK |
62 | respectively, except that they do not return their result in a static |
63 | buffer, but instead use the supplied | |
64 | .I buf | |
65 | of size | |
66 | .IR len . | |
67 | See | |
68 | .BR ecvt (3) | |
69 | and | |
70 | .BR qecvt (3). | |
47297adb | 71 | .SH RETURN VALUE |
fea681da | 72 | These functions return 0 on success, and \-1 otherwise. |
299cfca4 | 73 | .SH ATTRIBUTES |
13e527ea MS |
74 | For an explanation of the terms used in this section, see |
75 | .BR attributes (7). | |
76 | .TS | |
77 | allbox; | |
c466875e | 78 | lbx lb lb |
13e527ea MS |
79 | l l l. |
80 | Interface Attribute Value | |
81 | T{ | |
9e54434e BR |
82 | .na |
83 | .nh | |
13e527ea MS |
84 | .BR ecvt_r (), |
85 | .BR fcvt_r (), | |
13e527ea MS |
86 | .BR qecvt_r (), |
87 | .BR qfcvt_r () | |
88 | T} Thread safety MT-Safe | |
89 | .TE | |
3113c7f3 | 90 | .SH STANDARDS |
4131356c | 91 | GNU. |
fea681da | 92 | .SH NOTES |
c13182ef MK |
93 | These functions are obsolete. |
94 | Instead, | |
fb186734 | 95 | .BR sprintf (3) |
fea681da | 96 | is recommended. |
47297adb | 97 | .SH SEE ALSO |
fea681da MK |
98 | .BR ecvt (3), |
99 | .BR qecvt (3), | |
100 | .BR sprintf (3) |