Converts an ASCII string to a floating-point or double floating-point number.
Standard C Library (libc.a)
#include <stdlib.h>
double atof (NumberPointer) const char *NumberPointer;
float atoff (NumberPointer) char *NumberPointer;
The atof subroutine converts a character string, pointed to by the NumberPointer parameter, to a double-precision floating-point number. The atoff subroutine converts a character string, pointed to by the NumberPointer parameter, to a single-precision floating-point number. The first unrecognized character ends the conversion.
Except for behavior on error, the atof subroutine is equivalent to the strtod subroutine call, with the EndPointer parameter set to (char**) NULL.
Except for behavior on error, the atoff subroutine is equivalent to the strtof subroutine call, with the EndPointer parameter set to (char**) NULL.
These subroutines recognize a character string when the characters are in one of two formats: numbers or numeric symbols.
The atoff subroutine is not part of the ANSI C Library. These subroutines are at least as accurate as required by the IEEE Standard for Binary Floating-Point Arithmetic. The atof subroutine accepts at least 17 significant decimal digits. The atoff and subroutine accepts at least 9 leading 0's. Leading 0's are not counted as significant digits.
NumberPointer | Specifies a character string to convert. |
EndPointer | Specifies a pointer to the character that ended the scan or a null value. |
Upon successful completion, the atof, and atoff subroutines return the converted value. If no conversion could be performed, a value of 0 is returned and the errno global variable is set to indicate the error.
If the conversion cannot be performed, a value of 0 is returned, and the errno global variable is set to indicate the error.
If the conversion causes an overflow (that is, the value is outside the range of representable values), +/- HUGE_VAL is returned with the sign indicating the direction of the overflow, and the errno global variable is set to ERANGE.
If the conversion would cause an underflow, a properly signed value of 0 is returned and the errno global variable is set to ERANGE.
The atoff subroutine has only one rounding error. (If the atof subroutine is used to create a double-precision floating-point number and then that double-precision number is converted to a floating-point number, two rounding errors could occur.)
The scanf subroutine, atol, or atoi subroutine, wstrtol, watol, or watoi subroutine.
Subroutines Overview in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.
128-Bit long double Floating-Point Format in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.