Debian Codegraph @

upstream/debian-unstable/man3/qecvt.3

raw
1 '\" t
2 .\" Copyright 2002, Andries E. Brouwer <[email protected]>
3 .\" Copyright, the authors of the Linux man-pages project
4 .\"
5 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
6 .\"
7 .TH qecvt 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 qecvt, qfcvt, qgcvt \- convert a floating-point number to a string
10 .SH LIBRARY
11 Standard C library
12 .RI ( libc ,\~ \-lc )
13 .SH SYNOPSIS
14 .nf
15 .B #include <stdlib.h>
16 .P
17 .BI "[[deprecated]] char *qecvt(long double " number ", int " ndigits ,
18 .BI " int *restrict " decpt ", int *restrict " sign );
19 .BI "[[deprecated]] char *qfcvt(long double " number ", int " ndigits ,
20 .BI " int *restrict " decpt ", int *restrict " sign );
21 .BI "[[deprecated]] char *qgcvt(long double " number ", int " ndigit ", char *" buf );
22 .fi
23 .P
24 .RS -4
25 Feature Test Macro Requirements for glibc (see
26 .BR feature_test_macros (7)):
27 .RE
28 .P
29 .BR qecvt (),
30 .BR qfcvt (),
31 .BR qgcvt ():
32 .nf
33 Since glibc 2.19:
34 _DEFAULT_SOURCE
35 In glibc up to and including 2.19:
36 _SVID_SOURCE
37 .fi
38 .\" FIXME . The full FTM picture looks to have been something like the
39 .\" following mess:
40 .\" glibc 2.20 onward
41 .\" _DEFAULT_SOURCE
42 .\" glibc 2.18 to glibc 2.19
43 .\" _BSD_SOURCE || _SVID_SOURCE
44 .\" glibc 2.10 to glibc 2.17
45 .\" _SVID_SOURCE || (_XOPEN_SOURCE >= 500 ||
46 .\" (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED) &&
47 .\" ! (_POSIX_C_SOURCE >= 200809L))
48 .\" Before glibc 2.10:
49 .\" _SVID_SOURCE || _XOPEN_SOURCE >= 500 ||
50 .\" (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED)
51 .SH DESCRIPTION
52 The functions
53 .BR qecvt (),
54 .BR qfcvt (),
55 and
56 .BR qgcvt ()
57 are identical to
58 .BR ecvt (3),
59 .BR fcvt (3),
60 and
61 .BR gcvt (3)
62 respectively, except that they use a
63 .I "long double"
64 argument
65 .IR number .
66 See
67 .BR ecvt (3)
68 and
69 .BR gcvt (3).
70 .SH ATTRIBUTES
71 For an explanation of the terms used in this section, see
72 .BR attributes (7).
73 .TS
74 allbox;
75 lbx lb lb
76 l l l.
77 Interface Attribute Value
78 T{
79 .na
80 .nh
81 .BR qecvt ()
82 T} Thread safety MT-Unsafe race:qecvt
83 T{
84 .na
85 .nh
86 .BR qfcvt ()
87 T} Thread safety MT-Unsafe race:qfcvt
88 T{
89 .na
90 .nh
91 .BR qgcvt ()
92 T} Thread safety MT-Safe
93 .TE
94 .SH STANDARDS
95 None.
96 .SH HISTORY
97 SVr4, SunOS, GNU.
98 .\" Not supported by libc4 and libc5.
99 .P
100 These functions are obsolete.
101 Instead,
102 .BR snprintf (3)
103 is recommended.
104 .SH SEE ALSO
105 .BR ecvt (3),
106 .BR ecvt_r (3),
107 .BR gcvt (3),
108 .BR sprintf (3)