man3/qecvt.3

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