diff options
Diffstat (limited to 'man3/ecvt.3')
-rw-r--r-- | man3/ecvt.3 | 81 |
1 files changed, 81 insertions, 0 deletions
diff --git a/man3/ecvt.3 b/man3/ecvt.3 new file mode 100644 index 000000000..a7671fd93 --- /dev/null +++ b/man3/ecvt.3 @@ -0,0 +1,81 @@ +.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" +.\" References consulted: +.\" Linux libc source code +.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) +.\" 386BSD man pages +.\" Modified Sat Jul 24 19:40:39 1993 by Rik Faith (faith@cs.unc.edu) +.\" Modified Fri Jun 25 12:10:47 1999 by Andries Brouwer (aeb@cwi.nl) +.\" +.TH ECVT 3 1999-06-25 "" "Linux Programmer's Manual" +.SH NAME +ecvt, fcvt \- convert a floating-point number to a string +.SH SYNOPSIS +.B #include <stdlib.h> +.sp +.BI "char *ecvt(double " number ", int " ndigits ", int *" decpt , +.BI "int *" sign ); +.sp +.BI "char *fcvt(double " number ", int " ndigits ", int *" decpt , +.BI "int *" sign ); +.SH DESCRIPTION +The \fBecvt()\fP function converts \fInumber\fP to a null-terminated +string of \fIndigits\fP digits (where \fIndigits\fP is reduced to an +system-specific limit determined by the precision of a double), +and returns a pointer to the string. The high-order digit is nonzero, +unless +.I number +is zero. The low order digit is rounded. +The string itself does not contain a decimal point; however, +the position of the decimal point relative to the start of the string +is stored in *\fIdecpt\fP. A negative value for *\fIdecpt\fP means that +the decimal point is to the left of the start of the string. If the sign of +\fInumber\fP is negative, *\fIsign\fP is set to a non-zero value, otherwise +it's set to 0. If +.I number +is zero, it is unspecified whether *\fIdecpt\fP is 0 or 1. +.PP +The \fBfcvt()\fP function is identical to \fBecvt()\fP, except that +\fIndigits\fP specifies the number of digits after the decimal point. +.SH "RETURN VALUE" +Both the \fBecvt()\fP and \fBfcvt()\fP functions return a pointer to a +static string containing the ASCII representation of \fInumber\fP. +The static string is overwritten by each call to \fBecvt()\fP or +\fBfcvt()\fP. +.SH NOTES +These functions are obsolete. Instead, +.IR sprintf () +is recommended. +Linux libc4 and libc5 specified the type of +.I ndigits +as +.BR size_t . +Not all locales use a point as the radix character (`decimal point'). +.SH "CONFORMING TO" +SysVR2, XPG2 +.SH "SEE ALSO" +.BR ecvt_r (3), +.BR gcvt (3), +.BR qecvt (3), +.BR setlocale (3), +.BR sprintf (3) |