BSD 4_3_Net_2 release

[unix-history] / usr / src / lib / libc / stdlib / atof.3

diff --git a/usr/src/lib/libc/stdlib/atof.3 b/usr/src/lib/libc/stdlib/atof.3
index 7618900..4f30b50 100644 (file)
--- a/usr/src/lib/libc/stdlib/atof.3
+++ b/usr/src/lib/libc/stdlib/atof.3
@@ -1,53 +1,87 @@
-.\" Copyright (c) 1990 The Regents of the University of California.
+.\" Copyright (c) 1991 The Regents of the University of California.

 .\" All rights reserved.
 .\"
 .\" All rights reserved.
 .\"

-.\" %sccs.include.redist.man%
+.\" This code is derived from software contributed to Berkeley by
+.\" the American National Standards Committee X3, on Information
+.\" Processing Systems.

 .\"
 .\"

-.\"    @(#)atof.3      6.2 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.TH ATOF 3 ""
-.UC 7
-.SH NAME
-atof \- convert ASCII string to double
-.SH SYNOPSIS
-.nf
-.ft B
-#include <stdlib.h>
-
-double
-atof(const char *nptr);
-.ft R
-.fi
-.SH DESCRIPTION
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)atof.3     6.4 (Berkeley) 6/29/91
+.\"
+.Dd June 29, 1991
+.Dt ATOF 3
+.Os
+.Sh NAME
+.Nm atof
+.Nd convert
+.Tn ASCII
+string to double
+.Sh SYNOPSIS
+.Fd #include <stdlib.h>
+.Ft double
+.Fn atof "const char *nptr"
+.Sh DESCRIPTION

 The
 The

-.I atof
+.Fn atof

 function converts the initial portion of the string pointed to by
 function converts the initial portion of the string pointed to by

-.I nptr
+.Ar nptr

 to
 to

-.I double
+.Ar double

 representation.
 representation.

-.PP
+.Pp

 It is equivalent to:
 It is equivalent to:

-.sp
-.RS
+.Bd -literal -offset indent

 strtod(nptr, (char **)NULL);
 strtod(nptr, (char **)NULL);

-.RE
-.SH SEE ALSO
-atoi(3), atol(3), strtod(3), strtol(3), strtoul(3)
-.SH STANDARDS
-.B Atof
-conforms to ANSI X3.159-1989 (``ANSI C'').
-.SH BUGS
+.Ed
+.Sh SEE ALSO
+.Xr atoi 3 ,
+.Xr atol 3 ,
+.Xr strtod 3 ,
+.Xr strtol 3 ,
+.Xr strtoul 3
+.Sh STANDARDS
+The
+.Fn atof
+function conforms to
+.St -ansiC .
+.Sh BUGS

 This manual page represents intent instead of actual practice.
 While it is intended that
 This manual page represents intent instead of actual practice.
 While it is intended that

-.I atof
+.Fn atof

 be implemented using
 be implemented using

-.IR strtod (3),
+.Xr strtod 3 ,

 this has not yet happened.
 In the current system,
 this has not yet happened.
 In the current system,

-.I atof
-translates a string in the following form to a double:
-an optional string of spaces, followed by an optional sign (``+'' or ``-''),
-followed by a string of digits which may contain a decimal point (``.''),
-followed by an optional exponent flag (``E'' or ``e''), followed by an
-optionally signed integer.
+.Fn atof
+translates a string in the following form to a double: a string of
+leading white space, possibly followed by a sign (``+'' or ``-''),
+followed by a digit string which may contain one decimal point (``.''),
+which may be followed by either of the exponent flags (``E'' or ``e''),
+and lastly, followed by a signed or unsigned integer.