iOS Reference Library Apple Developer
Search

 

This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).



ATOF(3)                  BSD Library Functions Manual                  ATOF(3)

NAME
     atof, atof_l -- convert ASCII string to double

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <stdlib.h>

     double
     atof(const char *str);

     #include <xlocale.h>

     double
     atof_l(const char *str, locale_t loc);

DESCRIPTION
     The atof() function converts the initial portion of the string pointed to
     by str to double representation.

     It is equivalent to:

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

     The decimal point character is defined in the program's locale (category
     LC_NUMERIC).

     While the atof() function uses the current locale, the atof_l() function
     may be passed a locale directly. See xlocale(3) for more information.

IMPLEMENTATION NOTES
     The atof() function is not thread-safe and also not async-cancel-safe.

     The atof() function has been deprecated by strtod() and should not be
     used in new code.

ERRORS
     The function atof() need not affect the value of errno on an error.

SEE ALSO
     atoi(3), atol(3), strtod(3), strtol(3), strtoul(3), xlocale(3)

STANDARDS
     The atof() function conforms to ISO/IEC 9945-1:1990 (``POSIX.1''),
     ISO/IEC 9899:1990 (``ISO C90''), and ISO/IEC 9899:1999 (``ISO C99'').

BSD                              June 4, 1993                              BSD
Did this document help you? Yes It's good, but... Not helpful...