man3/qecvt.3

   1 '\" t
   2 .\" Copyright (C) 2002 Andries Brouwer <aeb@cwi.nl>
   3 .\"
   4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
   5 .\"
   6 .\" This replaces an earlier man page written by Walter Harms
   7 .\" <walter.harms@informatik.uni-oldenburg.de>.
   8 .\"
   9 .TH qecvt 3 (date) "Linux man-pages (unreleased)"
  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 .PP
  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 .PP
  26 .RS -4
  27 Feature Test Macro Requirements for glibc (see
  28 .BR feature_test_macros (7)):
  29 .RE
  30 .PP
  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 .sp 1
  97 .SH STANDARDS
  98 None.
  99 .SH HISTORY
 100 SVr4, SunOS, GNU.
 101 .\" Not supported by libc4 and libc5.
 102 .PP
 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)