ECVT_R

Section: Linux Programmer's Manual (3)
Updated: 2007-07-26
Index Return to Main Contents
 

NAME

ecvt_r, fcvt_r, qecvt_r, qfcvt_r - convert a floating-point number to a string  

SYNOPSIS

#include <stdlib.h>

int ecvt_r(double number, int ndigits, int *decpt,
           int *sign, char *buf, size_t len);

int fcvt_r(double number, int ndigits, int *decpt,
           int *sign, char *buf, size_t len);

int qecvt_r(long double number, int ndigits, int *decpt,
           int *sign, char *buf, size_t len);

int qfcvt_r(long double number, int ndigits, int *decpt,
           int *sign, char *buf, size_t len);

Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

ecvt_r(), fcvt_r(), qecvt_r(), qfcvt_r(): _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE >= 500  

DESCRIPTION

The functions ecvt_r(), fcvt_r(), qecvt_r() and qfcvt_r() are identical to ecvt(3), fcvt(3), qecvt(3) and qfcvt(3), respectively, except that they do not return their result in a static buffer, but instead use the supplied buf of size len. See ecvt(3) and qecvt(3).  

RETURN VALUE

These functions return 0 on success, and -1 otherwise.  

CONFORMING TO

These functions are GNU extensions.  

NOTES

These functions are obsolete. Instead, sprintf(3) is recommended.  

SEE ALSO

ecvt(3), qecvt(3), sprintf(3)  

COLOPHON

This page is part of release 3.22 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.