Debian Codegraph @

upstream/debian-trixie/man3/qecvt.3

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