158f0484fSRodney W. Grimes.\" Copyright (c) 1990, 1991, 1993 258f0484fSRodney W. Grimes.\" The Regents of the University of California. All rights reserved. 358f0484fSRodney W. Grimes.\" 458f0484fSRodney W. Grimes.\" This code is derived from software contributed to Berkeley by 558f0484fSRodney W. Grimes.\" the American National Standards Committee X3, on Information 658f0484fSRodney W. Grimes.\" Processing Systems. 758f0484fSRodney W. Grimes.\" 858f0484fSRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without 958f0484fSRodney W. Grimes.\" modification, are permitted provided that the following conditions 1058f0484fSRodney W. Grimes.\" are met: 1158f0484fSRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright 1258f0484fSRodney W. Grimes.\" notice, this list of conditions and the following disclaimer. 1358f0484fSRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright 1458f0484fSRodney W. Grimes.\" notice, this list of conditions and the following disclaimer in the 1558f0484fSRodney W. Grimes.\" documentation and/or other materials provided with the distribution. 1658f0484fSRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software 1758f0484fSRodney W. Grimes.\" must display the following acknowledgement: 1858f0484fSRodney W. Grimes.\" This product includes software developed by the University of 1958f0484fSRodney W. Grimes.\" California, Berkeley and its contributors. 2058f0484fSRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors 2158f0484fSRodney W. Grimes.\" may be used to endorse or promote products derived from this software 2258f0484fSRodney W. Grimes.\" without specific prior written permission. 2358f0484fSRodney W. Grimes.\" 2458f0484fSRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 2558f0484fSRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 2658f0484fSRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 2758f0484fSRodney W. Grimes.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 2858f0484fSRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 2958f0484fSRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 3058f0484fSRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 3158f0484fSRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 3258f0484fSRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 3358f0484fSRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 3458f0484fSRodney W. Grimes.\" SUCH DAMAGE. 3558f0484fSRodney W. Grimes.\" 3658f0484fSRodney W. Grimes.\" @(#)strtod.3 8.1 (Berkeley) 6/4/93 377f3dea24SPeter Wemm.\" $FreeBSD$ 3858f0484fSRodney W. Grimes.\" 3958f0484fSRodney W. Grimes.Dd June 4, 1993 4058f0484fSRodney W. Grimes.Dt STRTOD 3 4158f0484fSRodney W. Grimes.Os 4258f0484fSRodney W. Grimes.Sh NAME 4358f0484fSRodney W. Grimes.Nm strtod 4458f0484fSRodney W. Grimes.Nd convert 4558f0484fSRodney W. Grimes.Tn ASCII 4658f0484fSRodney W. Grimesstring to double 4725bb73e0SAlexey Zelkin.Sh LIBRARY 4825bb73e0SAlexey Zelkin.Lb libc 4958f0484fSRodney W. Grimes.Sh SYNOPSIS 5058f0484fSRodney W. Grimes.Fd #include <stdlib.h> 5158f0484fSRodney W. Grimes.Ft double 5258f0484fSRodney W. Grimes.Fn strtod "const char *nptr" "char **endptr" 5358f0484fSRodney W. Grimes.Sh DESCRIPTION 5458f0484fSRodney W. GrimesThe 5558f0484fSRodney W. Grimes.Fn strtod 5658f0484fSRodney W. Grimesfunction converts the initial portion of the string 5758f0484fSRodney W. Grimespointed to by 5858f0484fSRodney W. Grimes.Fa nptr 5958f0484fSRodney W. Grimesto 6058f0484fSRodney W. Grimes.Em double 6158f0484fSRodney W. Grimesrepresentation. 6258f0484fSRodney W. Grimes.Pp 6358f0484fSRodney W. GrimesThe expected form of the string is an optional plus (``+'') or minus 6458f0484fSRodney W. Grimessign (``\-'') followed by a sequence of digits optionally containing 6558f0484fSRodney W. Grimesa decimal-point character, optionally followed by an exponent. 6658f0484fSRodney W. GrimesAn exponent consists of an ``E'' or ``e'', followed by an optional plus 6758f0484fSRodney W. Grimesor minus sign, followed by a sequence of digits. 6858f0484fSRodney W. Grimes.Pp 6958f0484fSRodney W. GrimesLeading white-space characters in the string (as defined by the 7058f0484fSRodney W. Grimes.Xr isspace 3 7158f0484fSRodney W. Grimesfunction) are skipped. 7205a6e1e5SAndrey A. ChernovThe decimal point 7305a6e1e5SAndrey A. Chernovcharacter is defined in the program's locale (category LC_NUMERIC). 7458f0484fSRodney W. Grimes.Sh RETURN VALUES 7558f0484fSRodney W. GrimesThe 7658f0484fSRodney W. Grimes.Fn strtod 7758f0484fSRodney W. Grimesfunction returns the converted value, if any. 7858f0484fSRodney W. Grimes.Pp 7958f0484fSRodney W. GrimesIf 8058f0484fSRodney W. Grimes.Fa endptr 8158f0484fSRodney W. Grimesis not 8258f0484fSRodney W. Grimes.Dv NULL , 8358f0484fSRodney W. Grimesa pointer to the character after the last character used 8458f0484fSRodney W. Grimesin the conversion is stored in the location referenced by 8558f0484fSRodney W. Grimes.Fa endptr . 8658f0484fSRodney W. Grimes.Pp 8758f0484fSRodney W. GrimesIf no conversion is performed, zero is returned and the value of 8858f0484fSRodney W. Grimes.Fa nptr 8958f0484fSRodney W. Grimesis stored in the location referenced by 9058f0484fSRodney W. Grimes.Fa endptr . 9158f0484fSRodney W. Grimes.Pp 9258f0484fSRodney W. GrimesIf the correct value would cause overflow, plus or minus 9358f0484fSRodney W. Grimes.Dv HUGE_VAL 9458f0484fSRodney W. Grimesis returned (according to the sign of the value), and 95c23155a4SRuslan Ermilov.Er ERANGE 9658f0484fSRodney W. Grimesis stored in 9758f0484fSRodney W. Grimes.Va errno . 9858f0484fSRodney W. GrimesIf the correct value would cause underflow, zero is 9958f0484fSRodney W. Grimesreturned and 100c23155a4SRuslan Ermilov.Er ERANGE 10158f0484fSRodney W. Grimesis stored in 10258f0484fSRodney W. Grimes.Va errno . 10358f0484fSRodney W. Grimes.Sh ERRORS 104274b6244SAlexey Zelkin.Bl -tag -width Er 10558f0484fSRodney W. Grimes.It Bq Er ERANGE 10658f0484fSRodney W. GrimesOverflow or underflow occurred. 10742635956SRuslan Ermilov.El 10858f0484fSRodney W. Grimes.Sh SEE ALSO 10958f0484fSRodney W. Grimes.Xr atof 3 , 11058f0484fSRodney W. Grimes.Xr atoi 3 , 11158f0484fSRodney W. Grimes.Xr atol 3 , 11258f0484fSRodney W. Grimes.Xr strtol 3 , 11358f0484fSRodney W. Grimes.Xr strtoul 3 11458f0484fSRodney W. Grimes.Sh STANDARDS 11558f0484fSRodney W. GrimesThe 11658f0484fSRodney W. Grimes.Fn strtod 11758f0484fSRodney W. Grimesfunction 11858f0484fSRodney W. Grimesconforms to 11958f0484fSRodney W. Grimes.St -ansiC . 12058f0484fSRodney W. Grimes.Sh AUTHORS 121a5941fc2SPhilippe CharnierThe author of this software is 122a5941fc2SPhilippe Charnier.An David M. Gay . 12358f0484fSRodney W. Grimes.Pp 12458f0484fSRodney W. GrimesCopyright (c) 1991 by AT&T. 12558f0484fSRodney W. Grimes.Pp 12658f0484fSRodney W. GrimesPermission to use, copy, modify, and distribute this software for any 12758f0484fSRodney W. Grimespurpose without fee is hereby granted, provided that this entire notice 12858f0484fSRodney W. Grimesis included in all copies of any software which is or includes a copy 12958f0484fSRodney W. Grimesor modification of this software and in all copies of the supporting 13058f0484fSRodney W. Grimesdocumentation for such software. 13158f0484fSRodney W. Grimes.Pp 13258f0484fSRodney W. GrimesTHIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED 13358f0484fSRodney W. GrimesWARRANTY. IN PARTICULAR, NEITHER THE AUTHOR NOR AT&T MAKES ANY 13458f0484fSRodney W. GrimesREPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY 13558f0484fSRodney W. GrimesOF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE. 13658f0484fSRodney W. Grimes.Pp 13758f0484fSRodney W. GrimesContact your vendor for a free copy of the source code to 13858f0484fSRodney W. Grimes.Fn strtod 13958f0484fSRodney W. Grimesand accompanying functions. 140