manual page distributed with 4.1BSD
authorKirk McKusick <mckusick@ucbvax.Berkeley.EDU>
Thu, 16 May 1985 05:54:28 +0000 (21:54 -0800)
committerKirk McKusick <mckusick@ucbvax.Berkeley.EDU>
Thu, 16 May 1985 05:54:28 +0000 (21:54 -0800)
SCCS-vsn: lib/libcompat/4.3/ecvt.3 4.1

usr/src/lib/libcompat/4.3/ecvt.3 [new file with mode: 0644]

diff --git a/usr/src/lib/libcompat/4.3/ecvt.3 b/usr/src/lib/libcompat/4.3/ecvt.3
new file mode 100644 (file)
index 0000000..8663099
--- /dev/null
@@ -0,0 +1,64 @@
+.\"    @(#)ecvt.3      4.1 (Berkeley) %G%
+.\"
+.TH ECVT 3 
+.AT 3
+.SH NAME
+ecvt, fcvt, gcvt \- output conversion
+.SH SYNOPSIS
+.nf
+.B char *ecvt(value, ndigit, decpt, sign)
+.B double value;
+.B int ndigit, *decpt, *sign;
+.PP
+.B char *fcvt(value, ndigit, decpt, sign)
+.B double value;
+.B int ndigit, *decpt, *sign;
+.PP
+.B char *gcvt(value, ndigit, buf)
+.B double value;
+.B char *buf;
+.fi
+.SH DESCRIPTION
+.I Ecvt
+converts the 
+.I value
+to a null-terminated string of
+.I ndigit
+ASCII digits
+and returns a pointer thereto.
+The position of the decimal point relative to the
+beginning of the string is stored indirectly
+through
+.IR decpt ""
+(negative means to the left of the
+returned digits).
+If the sign of the result is negative,
+the word pointed to by
+.IR sign ""
+is non-zero, otherwise
+it is zero.
+The low-order digit is rounded.
+.PP
+.IR Fcvt " is identical to " "ecvt\fR, except that the correct digit"
+has been rounded for Fortran F-format output of the number
+of digits specified by
+.IR \(*_ndigits .
+.PP
+.I Gcvt
+converts the
+.I value
+to a null-terminated ASCII string in
+.I buf
+and returns a pointer to 
+.I buf.
+It attempts to produce
+.I ndigit
+significant digits in Fortran F format if
+possible, otherwise E format, ready for
+printing.
+Trailing zeros may be suppressed.
+.SH "SEE ALSO"
+printf(3)
+.SH BUGS
+The return values point to static data
+whose content is overwritten by each call.