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